# j-FileUploader

> Prosty element do przesyłania plików. obsługuje automatyczne odtwarzanie obrazów.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: pl
Content-SHA256: 03d811cae3502743c8664e5d4f9fe39a54ff1aa24f49b7847afa2630f2c268f7
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Prosty element do przesyłania plików. obsługuje automatyczne odtwarzanie obrazów.

- __WYWIĄZANE: w jComponent v20 wartość `opt.url` musi być w formie `POST /url/`

__Konfiguracja__:

- `url {String}` domyślny adres URL do przesyłania

__Metody__:

- `fileuploader/upload(opt)` pokazuje dialog plików
	- `opt.url {String}` __important__ URL gdzie zostanie przesyłany obraz
	- `opt.callback(response, errors) {Function}` - ważny zwrot
	- `opt.multiple {Boolean}` obsługuje wiele plików (default: `false`)
	- `opt.progress(percentage)` Funkcja
	- Typ akceptowalny `opt.accept {String}` (default: `*/*`)
	- `opt.prefix {String}` prefix nazwa `<input name="file{0}"` (default: `file{0}`)
	- `opt.files {FileList}` opcjonalny (jeśli używasz np. Drag & Drop)
	- `opt.data {Object}` Opcjonalne, dodatkowe dane osobowe `key_string:value_string`
	- `opt.width {Number}` opcjonalny, szerokość obrazu
	- `opt.height {Number}` opcjonalny, wysokość obrazu
	- `opt.background {String}` opcjonalny, kolor tła zdefiniowany w HEX lub może być `transparent`
	- `opt.keeporiginal {Boolean}` opcjonalny, zapobiega podwójnemu rezygnacji (default: `false`)
	- `opt.onlylarger {Boolean}` opcjonalny, odtwarza obrazy tylko większe niż `opt.width` lub `opt.height`
	- `opt.base64 {String}` opcjonalny, może zawierać ważny format `dataURI` (wymagany do wypełnienia `opt.filename`)
	- `opt.filename {String}` opcjonalny, wymagany z pola `opt.base64`
	- `opt.quality {Number}` opcjonalne, standardowe jakości JPEG (default: `90`)
	- Nowa wersja: `opt.disproportionate {Boolean}` Użyj `opt.width` lub `opt.height` Maksymalne wartości

__Przyjazne komponenty__:
Ten element działa z `loading`, gdy plik jest pobierany.

Użyj go z `<ui-component name="fileuploader">`Gdy element nie jest jeszcze ładowany, jComponent Pobierz go po pierwszym użyciu z adresu `DEF.fallback` (Wydaje się Componentator Autor: Peter Širka Źródło: Componentator Zestaw składników, licencja 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>
```