# j-Folder

> Komponent dokáže vykresliť obsah ako prehliadač súborov. cesta musí byť v tvare napr. Adresár/Adresár/Súbor. Učte sa z príkladu.

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

Komponent dokáže vykresliť obsah ako prehliadač súborov. `path` musí byť v tvare napr. `Directory/Directory/File`. Učte sa z príkladu.


__Konfigurácia__:

- `up {String}` označenie pre tlačidlo Hore (predvolené: `..`)
- `delimiter {String}` oddeľovač pre cestu (predvolené: `/`)
- `root {String}` štítok pre prvú položku v strúhanke (predvolené: `Root`)
- `scrollbar {Boolean}` umožňuje vlastný posuvník (predvolené: `true`)
- `scrollbarY {Boolean}` vždy zobrazuje Y posuvník (predvolené: `false`)
- `delimiter {String}` oddeľovač cesty (predvolené: `/`)
- `options {String}` cesta k metóde `function(item, el)` (užívateľ musí kliknúť na pravé tlačidlo)
- `click {String}` cesta k premennej alebo metóda `function(item)` (používateľ musí kliknúť na položku)
- `checked {String}` cesta k premennej alebo metóde `function(checked_items, component)` (užívateľ musí zaškrtnúť políčko)
- `browse {String}` __IMPORTANT__: cesta k metóde `function(path, next(ARRAY), [item])`, ktorá musí vrátiť obsah pre komponent
- `parent {String}` voliteľné, kontajner s pevnou výškou, môže byť `window`. Predvolená hodnota: `component.element()`
- `margin {Number}` voliteľné, horný/dolný okraj spolu (predvolené: `0`)
- `drop {String}` voliteľné, cesta k metóde, ktorá sa vykoná, ak sa súbor presunie myšou
- `key {String}` voliteľné, názov kľúča na vytvorenie cesty (predvolené: `name`)
- `raw {Boolean}` voliteľné, zakáže kódovanie HTML `name` (predvolené: `false`)
- __NEW__: `contextmenu {String}` voliteľné, cesta k metóde `function(item, el, e)` (keď používateľ zobrazí kontextovú ponuku)

```js
function fn_browser(path, next, item) {

	// @path {String} paths divided according to the "config.delimiter"
	// @next {Function(Array)} importat: this function expects array with items
	// @item {Object} can be null

	var arr = [];

	// Object for array:
	// obj.name {String} a label/name
	// obj.checkbox {Boolean} enables checkbox (default: false)
	// obj.checked {Boolean} item will be checked
	// obj.icon {String} a icon for item
	// obj.type {Number} determines a type of item (1: directory, other: file)
	// obj.classname {String} adds a CSS class onto "label" element

	// Good to know:
	// Only directories can be drilled

	// Example:
	arr.push({ name: 'Node.js', checkbox: true, type: 1, icon: 'folder' });
	arr.push({ name: 'Client-Side', checkbox: true, type: 1, icon: 'folder' });

	next(arr);
	// next(array, noscroll);
}
```

Použite ho so `<ui-component name="folder">`. 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
<div class="container">
	<br />
	<ui-component name="folder" path="currentpath" config="browse:fn_browse;checked:fn_checked;click:fn_click" style="height:500px"></ui-component>
	<br />
</div>

<script>

	var currentpath = 'Frameworks/Node.js';

	function fn_browse(path, next, item) {

		var arr = [];

		switch (path) {
			case 'Frameworks':
				arr.push({ name: 'Node.js', checkbox: true, type: 1, icon: 'folder' });
				arr.push({ name: 'Client-Side', checkbox: true, type: 1, icon: 'folder' });
				break;
			case 'Frameworks/Node.js':
				arr.push({ name: 'Total.js', checkbox: true, checked: true, icon: 'file' });
				arr.push({ name: 'Express.js', checkbox: true, icon: 'file' });
				arr.push({ name: 'Koa.js', checkbox: true, icon: 'file' });
				arr.push({ name: 'Meteor.js', checkbox: true, icon: 'file' });
				break;
			case 'Frameworks/Client-Side':
				arr.push({ name: 'React', checkbox: true, icon: 'file' });
				arr.push({ name: 'Vue', checkbox: true, icon: 'file' });
				arr.push({ name: 'jComponent', checkbox: true, checked: true, icon: 'file' });
				arr.push({ name: 'Angular.js', checkbox: true, icon: 'file' });
				arr.push({ name: 'jQuery', checkbox: true, icon: 'file' });
				break;
			default:
				arr.push({ name: 'Frameworks', checkbox: true, type: 1, icon: 'folder' });
				arr.push({ name: 'Item 1', checkbox: true, icon: 'file' });
				arr.push({ name: 'Item 2', checkbox: true, icon: 'file' });
				arr.push({ name: 'Item 3', checkbox: true, icon: 'file' });
				break;
		}

		next(arr);
	}

	function fn_click(item) {
		console.log('click', item);
	}

	function fn_checked(arr) {
		console.log('checked', arr);
	}

</script>
```