# j-FileUploader

> Прост компонент за изтегляне на файлове. Поддържа автоматично рециклиране на изображения.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: bg
Content-SHA256: 8000f662416c2bf86b380ae7ab2c2f98539724c8ba4d6f5a815b5526e3f17b19
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Прост компонент за изтегляне на файлове. Поддържа автоматично рециклиране на изображения.

- В jComponent v20 стойността на `opt.url` трябва да бъде във формата на `POST /url/`.

__Конфигуриране__:

- `url {String}` - URL адрес за изтегляне

__Методи__:

- `fileuploader/upload(opt)` показва диалог с файлове
	- `opt.url {String}` __important__ URL, където ще бъде изтеглена изображението
	- `opt.callback(response, errors) {Function}` Връщане – важен
	- `opt.multiple {Boolean}` поддържа няколко файла (предварително: `false`)
	- `opt.progress(percentage)` {Функция}
	- Приемане на `opt.accept {String}` тип (предварително: `*/*`)
	- `opt.prefix {String}` - префикс на име `<input name="file{0}"` (предварително: `file{0}`)
	- `opt.files {FileList}` опция (ако използвате например Drag & Drop)
	- `opt.data {Object}` опция, допълнителни персонализирани данни `key_string:value_string`
	- `opt.width {Number}` опция, изображение ширина
	- `opt.height {Number}` опция, изображение височина
	- `opt.background {String}` е опционален, цветът на фона е дефиниран в HEX или може да бъде `transparent`
	- `opt.keeporiginal {Boolean}` опционално, предотвратява двойното рецидиране (предварително: `false`)
	- `opt.onlylarger {Boolean}` опционално, възпроизвежда изображения само по-големи от `opt.width` или `opt.height`
	- `opt.base64 {String}` опционален, той може да съдържа валиден формат `dataURI` (необходим за попълване на `opt.filename`)
	- `opt.filename {String}` е задължително, изисквано с полето `opt.base64`.
	- `opt.quality {Number}` опционално, стандартно качество JPEG (предварително: `90`)
	- __NEW__: `opt.disproportionate {Boolean}` използва `opt.width` или `opt.height` като максимални стойности

__Приятелски компоненти__:
Този компонент работи с `loading`, когато файлът е изтеглен.

Използвайте го с `<ui-component name="fileuploader">`Когато компонентът все още не е зареден, jComponent Изтегляне на първия адрес в `DEF.fallback` (След това Componentator Източник: Питър Шерка Componentator Съставни съставки, лиценз на 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>
```