# j-FileUploader

> Jednoduchá složka pro nahrávání souborů. Podporuje automaticky rezignační obrázky.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: cs
Content-SHA256: 31313d5eb67c8e8fc564149e9e81a16555018f1ee41bb10c257e16f994eb0a9d
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Jednoduchá složka pro nahrávání souborů. Podporuje automaticky rezignační obrázky.

- __IMPORTANT__: v jComponent v20, hodnota `opt.url` musí být ve formě `POST /url/`

__Konfigurace__:

- `url {String}` - předvolená adresa URL pro uploadu

__Metody__:

- `fileuploader/upload(opt)` zobrazuje souborový dialog
	- `opt.url {String}` __important__ URL, kde se zobrazí obrázek
	- `opt.callback(response, errors) {Function}` - důležitý
	- `opt.multiple {Boolean}` podporuje více souborů (předvolené: `false`)
	- `opt.progress(percentage)` funkce
	- Typ přijetí `opt.accept {String}` (předvolený: `*/*`)
	- `opt.prefix {String}` předpověď názvu `<input name="file{0}"` (podmínka: `file{0}`)
	- `opt.files {FileList}` volitelné (pokud používáte např. Drag & Drop)
	- `opt.data {Object}` volitelné, dodatečné přizpůsobené údaje `key_string:value_string`
	- `opt.width {Number}` volitelné, šířka obrazu
	- `opt.height {Number}` volitelná, výška obrazu
	- `opt.background {String}` volitelná, barva pozadí definovaná v HEX nebo může být `transparent`
	- `opt.keeporiginal {Boolean}` volitelně, zabrání dvojímu rezignaci (podmínkou: `false`)
	- `opt.onlylarger {Boolean}` volitelně, zobrazuje pouze obrázky větší než `opt.width` nebo `opt.height`
	- `opt.base64 {String}` je volitelný, může obsahovat platný formát `dataURI` (potřebuje se vyplnit `opt.filename`)
	- `opt.filename {String}` volitelné, požadované s pole `opt.base64`
	- `opt.quality {Number}` volitelné, standardní kvalita JPEG (default: `90`)
	- __NEW__: `opt.disproportionate {Boolean}` používá `opt.width` nebo `opt.height` jako maximální hodnoty

__Přátelské komponenty__:
Tato složka pracuje s `loading` při stahování souboru.

Použijte ji s `<ui-component name="fileuploader">`Pokud je součástka ještě nezačleněna, jComponent Stáhnout ji na první použití z adresy `DEF.fallback` a) The Componentator CDN dle předvolby. autor: Peter Širka. zdroj: Componentator Výrobce je autorizován, MIT licence.

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