j-Folder

jComponent 20 · jcomponent@20 component Exemple chargé avec jComponent 20

Le composant peut restituer un contenu tel qu'un navigateur de fichiers. path doit être au format par ex. Directory/Directory/File. Apprenez de l’exemple.

Configuration :

up {String} une étiquette pour le bouton Haut (par défaut : ..)
delimiter {String} un délimiteur pour le chemin (par défaut : /)
root {String} une étiquette pour le premier élément du fil d'Ariane (par défaut : Root)
scrollbar {Boolean} active la barre de défilement personnalisée (par défaut : true)
scrollbarY {Boolean} affiche toujours la barre de défilement Y (par défaut : false)
delimiter {String} un délimiteur de chemin (par défaut : /)
options {String} un chemin vers la méthode function(item, el) (l'utilisateur doit cliquer sur le bouton droit)
click {String} un chemin vers la variable ou la méthode function(item) (l'utilisateur doit cliquer sur l'élément)
checked {String} un chemin vers la variable ou la méthode function(checked_items, component) (l'utilisateur doit cocher la case)
browse {String} IMPORTANT : un chemin vers la méthode function(path, next(ARRAY), [item]) qui doit retourner un contenu pour le composant
parent {String} en option, un conteneur à hauteur fixe, peut être window. Valeur par défaut : component.element()
margin {Number} en option, une marge supérieure/inférieure ensemble (par défaut : 0)
drop {String} facultatif, un chemin vers la méthode qui sera exécutée si un fichier est glissé-déposé
key {String} facultatif, un nom de clé pour la création du chemin (par défaut : name)
raw {Boolean} facultatif, désactive l'encodage HTML name (par défaut : false)
NEW : contextmenu {String} facultatif, un chemin vers la méthode function(item, el, e) (lorsqu'un utilisateur affiche le menu contextuel)

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);
}

Utilisez-le avec <ui-component name="folder">. Lorsque le composant n'est pas encore chargé, jComponent le télécharge lors de la première utilisation depuis l'adresse dans DEF.fallback (le CDN Componentator par défaut). Auteur : Peter Širka. Source : le référentiel de composants Componentator, licence MIT.

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>