# j-FileUploader

> Um componente simples para upload de arquivos. Ele suporta imagens de resgate automático.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: pt
Content-SHA256: 97f6bd1f81954f662dcdac5c3a89863e452f276aa89cd85ad366bf5d3ac83927
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Um componente simples para upload de arquivos. Ele suporta imagens de resgate automático.

- __ IMPORTANTE__: em jComponent v20, o valor de `opt.url` deve ser na forma `POST /url/`

__Configuração__:

- `url {String}` é um endereço URL padrão para upload

__Métodos__:

- `fileuploader/upload(opt)` mostra um diálogo de arquivo
	- `opt.url {String}` __important__ URL onde a imagem será carregada
	- `opt.callback(response, errors) {Function}` um callback __importante__
	- `opt.multiple {Boolean}` suporta vários arquivos (default: `false`)
	- `opt.progress(percentage)` - Função
	- `opt.accept {String}` tipo aceito (default: `*/*`)
	- `opt.prefix {String}` um prefixo de nome `<input name="file{0}"` (default: `file{0}`)
	- `opt.files {FileList}` opcional (se você usar, por exemplo, Drag & Drop)
	- `opt.data {Object}` opcional, dados adicionais personalizados `key_string:value_string`
	- `opt.width {Number}` opcional, largura de imagem
	- `opt.height {Number}` opcional, altura da imagem
	- `opt.background {String}` opcional, cor de fundo definida em HEX ou pode ser `transparent`
	- `opt.keeporiginal {Boolean}` opcional, evita a dupla resisão (default: `false`)
	- `opt.onlylarger {Boolean}` é opcional, reside imagens maiores do que `opt.width` ou `opt.height`.
	- `opt.base64 {String}` opcional, pode conter um formato `dataURI` válido (necessário para preencher o `opt.filename`)
	- `opt.filename {String}` opcional, exigido com o campo `opt.base64`
	- `opt.quality {Number}` opcional, uma qualidade JPEG padrão (default: `90`)
	- __NEW__: `opt.disproportionate {Boolean}` usa `opt.width` ou `opt.height` como valores máximos

__Componentes Amigáveis__:
Este componente funciona com `loading` quando o arquivo é carregado.

Use-o com `<ui-component name="fileuploader">`Quando o componente ainda não está carregado, jComponent Descarrega-o no primeiro uso do endereço `DEF.fallback` (a partir do Componentator CDN por padrão). autor: Peter Širka. fonte: o Componentator Reserva de componentes, licença 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>
```