# j-FileUploader

> Jednoduchý komponent na nahrávanie súborov. Podporuje automatickú zmenu veľkosti obrázkov.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: sk
Content-SHA256: 8f2a7285fe55b928dfd5f94ee565da17b5c854d0648e52ef13d3280f45fbcef9
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Jednoduchý komponent na nahrávanie súborov. Podporuje automatickú zmenu veľkosti obrázkov.

- __DÔLEŽITÉ__: v jComponent v20 musí byť hodnota `opt.url` v tvare `POST /url/`

__Konfigurácia__:

- `url {String}` predvolená adresa URL na nahrávanie

__Metódy__:

- `fileuploader/upload(opt)` zobrazí dialógové okno súboru
	- `opt.url {String}` __dôležitá__ adresa URL, na ktorú sa nahrá obrázok
	- `opt.callback(response, errors) {Function}` spätné volanie __dôležité__
	- `opt.multiple {Boolean}` podporuje viacero súborov (predvolené: `false`)
	- `opt.progress(percentage)` {Funkcia}
	- Typ prijatia `opt.accept {String}` (predvolené: `*/*`)
	- `opt.prefix {String}` predpona názvu `<input name="file{0}"` (predvolené: `file{0}`)
	- `opt.files {FileList}` voliteľné (ak používate napr. Drag & Drop)
	- `opt.data {Object}` voliteľné, ďalšie vlastné údaje `key_string:value_string`
	- `opt.width {Number}` voliteľné, šírka obrazu
	- `opt.height {Number}` voliteľné, výška obrazu
	- `opt.background {String}` voliteľné, farba pozadia definovaná v HEX alebo môže byť `transparent`
	- `opt.keeporiginal {Boolean}` voliteľné, zabraňuje dvojitej zmene veľkosti (predvolené: `false`)
	- `opt.onlylarger {Boolean}` voliteľné, zmení veľkosť obrázkov iba na väčšie ako `opt.width` alebo `opt.height`
	- `opt.base64 {String}` voliteľné, môže obsahovať platný formát `dataURI` (vyžaduje sa na vyplnenie `opt.filename`)
	- `opt.filename {String}` voliteľné, vyžaduje sa s poľom `opt.base64`
	- `opt.quality {Number}` voliteľné, predvolená kvalita JPEG (predvolená: `90`)
	- __NEW__: `opt.disproportionate {Boolean}` použite `opt.width` alebo `opt.height` ako maximálne hodnoty

__Priateľské komponenty__:
Tento komponent funguje so `loading` pri nahrávaní súboru.

Použite ho so `<ui-component name="fileuploader">`. Keď komponent ešte nie je načítaný, jComponent ho stiahne pri prvom použití z adresy v `DEF.fallback` (predvolene CDN Componentator). Autor: Peter Širka. Zdroj: úložisko komponentov Componentator, licencia 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>
```