# j-FileUploader

> Un semplice componente per il caricamento dei file. supporta immagini di ripresa automatica.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: it
Content-SHA256: 9c51dfd45bfc1e934193caf58772f2723a920babf9119618b8662b3acbbf8db6
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Un semplice componente per il caricamento dei file. supporta immagini di ripresa automatica.

- __IMPORTANTE__: in jComponent v20, il valore di `opt.url` deve essere nel modulo `POST /url/`

__Configurazione__:

- `url {String}` un indirizzo URL predefinito per il caricamento

__Metodi__:

- `fileuploader/upload(opt)` mostra un file di dialogo
	- `opt.url {String}` __importante__ URL dove verrà caricato l'immagine
	- `opt.callback(response, errors) {Function}` un appuntamento _importante__
	- `opt.multiple {Boolean}` supporta più file (default: `false`)
	- `opt.progress(percentage)` di funzione
	- Tipo di accettazione `opt.accept {String}` (default: `*/*`)
	- `opt.prefix {String}` un prefix di nome `<input name="file{0}"` (default: `file{0}`)
	- `opt.files {FileList}` opzionale (se si utilizza ecc Drag & Drop)
	- `opt.data {Object}` opzionale, dati personalizzati aggiuntivi `key_string:value_string`
	- `opt.width {Number}` opzionale, larghezza immagine
	- `opt.height {Number}` opzionale, altezza dell'immagine
	- `opt.background {String}` opzionale, colore di sfondo definito in HEX o può essere `transparent`
	- `opt.keeporiginal {Boolean}` opzionale, previene la doppia resisione (default: `false`)
	- `opt.onlylarger {Boolean}` opzionale, reside le immagini solo più grandi di `opt.width` o `opt.height`
	- `opt.base64 {String}` opzionale, può contenere un formato valido `dataURI` (necessario per riempire `opt.filename`)
	- `opt.filename {String}` opzionale, richiesto con il campo `opt.base64`
	- `opt.quality {Number}` opzionale, una qualità JPEG predefinita (predefinito: `90`)
	- __NEW__: `opt.disproportionate {Boolean}` utilizza `opt.width` o `opt.height` come valori massimi

__Componenti amichevoli__:
Questo componente funziona con `loading` quando il file è caricato.

Utilizzare con `<ui-component name="fileuploader">`Quando il componente non è ancora caricato, jComponent Scarica il codice in prima utilizzazione dall'indirizzo `DEF.fallback` (Il Componentator La storia di Peter Širka.Fonte: il Componentator Ristorante dei componenti, licenza MIT.

```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>
```