# j-FileUploader

> Un composant simple pour télécharger des fichiers. Il prend en charge le redimensionnement automatique des images.

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

Un composant simple pour télécharger des fichiers. Il prend en charge le redimensionnement automatique des images.

- __IMPORTANT__ : dans jComponent v20, la valeur de `opt.url` doit être sous la forme `POST /url/`

__Configuration__ :

- `url {String}` une adresse URL par défaut pour le téléchargement

__Méthodes__ :

- `fileuploader/upload(opt)` affiche une boîte de dialogue de fichier
	- `opt.url {String}` __important__ URL où l'image sera téléchargée
	- `opt.callback(response, errors) {Function}` un rappel __important__
	- `opt.multiple {Boolean}` prend en charge plusieurs fichiers (par défaut : `false`)
	- `opt.progress(percentage)` {Fonction}
	- `opt.accept {String}` accepte le type (par défaut : `*/*`)
	- `opt.prefix {String}` un préfixe de nom `<input name="file{0}"` (par défaut : `file{0}`)
	- `opt.files {FileList}` en option (si vous utilisez par exemple le glisser-déposer)
	- `opt.data {Object}` en option, données personnalisées supplémentaires `key_string:value_string`
	- `opt.width {Number}` en option, largeur d'image
	- `opt.height {Number}` en option, hauteur de l'image
	- `opt.background {String}` en option, couleur d'arrière-plan définie en HEX ou peut être `transparent`
	- `opt.keeporiginal {Boolean}` en option, empêche le double redimensionnement (par défaut : `false`)
	- `opt.onlylarger {Boolean}` en option, redimensionne les images uniquement plus grandes que `opt.width` ou `opt.height`
	- `opt.base64 {String}` facultatif, il peut contenir un format `dataURI` valide (obligatoire pour remplir `opt.filename`)
	- `opt.filename {String}` en option, requis avec le champ `opt.base64`
	- `opt.quality {Number}` en option, une qualité JPEG par défaut (par défaut : `90`)
	- __NOUVEAU__ : `opt.disproportionate {Boolean}` utilise `opt.width` ou `opt.height` comme valeurs maximales

__Composants conviviaux__ :
Ce composant fonctionne avec `loading` lors du téléchargement du fichier.

Utilisez-le avec `<ui-component name="fileuploader">`. Lorsque le composant n'est pas encore chargé, jComponent le télécharge lors de la première utilisation depuis l'adresse dans `DEF.fallback` (le CDN Componentator par défaut). Auteur : Peter Širka. Source : le référentiel de composants Componentator, licence 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>
```