# j-FileUploader

> Eine einfache Komponente zum Hochladen von Dateien. Es unterstützt die automatische Größenänderung von Bildern.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: de
Content-SHA256: 3ea0b8483ac5c7a0efccdfacdcbac1eee97afbdd0ca28f9a50d07be4b44a927c
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Eine einfache Komponente zum Hochladen von Dateien. Es unterstützt die automatische Größenänderung von Bildern.

- __WICHTIG__: In jComponent v20 muss der Wert von `opt.url` die Form `POST /url/` haben

__Konfiguration__:

- `url {String}` eine Standard-URL-Adresse zum Hochladen

__Methoden__:

- `fileuploader/upload(opt)` zeigt einen Dateidialog an
	- `opt.url {String}` __important__ URL, wo das Bild hochgeladen wird
	- `opt.callback(response, errors) {Function}` ein Rückruf __wichtig__
	- `opt.multiple {Boolean}` unterstützt mehrere Dateien (Standard: `false`)
	- `opt.progress(percentage)` {Funktion}
	- `opt.accept {String}` akzeptiert den Typ (Standard: `*/*`)
	- `opt.prefix {String}` ein Namenspräfix `<input name="file{0}"` (Standard: `file{0}`)
	- `opt.files {FileList}` optional (wenn Sie z.B. Drag & Drop verwenden)
	- `opt.data {Object}` optional, zusätzliche benutzerdefinierte Daten `key_string:value_string`
	- `opt.width {Number}` optional, Bildbreite
	- `opt.height {Number}` optional, Bildhöhe
	- `opt.background {String}` optional, Hintergrundfarbe in HEX definiert oder kann `transparent` sein
	- `opt.keeporiginal {Boolean}` optional, verhindert doppelte Größenänderung (Standard: `false`)
	- `opt.onlylarger {Boolean}` optional, ändert die Größe von Bildern nur größer als `opt.width` oder `opt.height`
	- `opt.base64 {String}` optional, es kann ein gültiges `dataURI`-Format enthalten (erforderlich, um `opt.filename` auszufüllen)
	- `opt.filename {String}` optional, erforderlich mit dem Feld `opt.base64`
	- `opt.quality {Number}` optional, eine Standard-JPEG-Qualität (Standard: `90`)
	- __NEU__: `opt.disproportionate {Boolean}` verwendet `opt.width` oder `opt.height` als Maximalwerte

__Freundliche Komponenten__:
Diese Komponente funktioniert mit `loading`, wenn die Datei hochgeladen wird.

Verwenden Sie es mit `<ui-component name="fileuploader">`. Wenn die Komponente noch nicht geladen ist, lädt jComponent sie bei der ersten Verwendung von der Adresse in `DEF.fallback` herunter (standardmäßig das CDN Componentator). Autor: Peter Širka. Quelle: Componentator-Komponenten-Repository, MIT-Lizenz.

```html example.html
<ui-component name="fileuploader"></ui-component>
<div class="exec link" data-exec="upload">Upload</div>

<script>
	function upload() {

		var opt = {};

		opt.url = '/api/upload/';

		// jComponent v20:
		// opt.url = 'POST /api/upload/';

		// opt.multiple = true;
		// opt.accept = 'text/*';

		opt.callback = function(response, err) {
			console.log(response, err);
		};
		opt.progress = function(percentage) {
			console.log(percentage);
		};

		SETTER('fileuploader/upload', opt);
	}
</script>
```