j-Properties

jComponent 20 · jcomponent@20 component Príklad načítaný s jComponent 20

Komponent využíva komponenty j-DatePicker, j-TimePicker, j-Directory, j-Emoji, j-ColorPicker a j-FaIcons.

Konfigurácia:

dateformat {String} formát dátumu (predvolené: yyyy-MM-dd)
timeformat {String} formát času (predvolené: HH:mm)
datetimeformat {String} formát dátumu a času (predvolené: yyyy-MM-dd HH:mm)
height {číslo} výška prvku (predvolené: undefined)
parent {String} volič jQuery pre automatické nastavenie výšky (môže byť window, parent alebo custom)
margin {číslo} zvislý okraj (predvolené: 0)
change {String} cesta k metóde method(item, replace_text(new_text)) (vykonaná, ak sa zmení nejaká hodnota) a argument replace_text je voliteľný
scrollbar {Boolean} povoľuje posuvník (predvolené: true)
visibleY {Boolean} zobrazuje posuvník (predvolené: true)

Prehlásenie o údajoch:

var form = [];
form.push({ group: 'Personal', label: 'First name', name: 'user.firstname', type: 'string', value: 'Peter', transform: 'capitalize' });
form.push({ group: 'Personal', label: 'Last name', name: 'user.lastname', type: 'string', value: 'Širka', placeholder: 'String' });
form.push({ group: 'Personal', label: 'Age', name: 'user.age', type: 'number', value: 33, min: 30 });
form.push({ group: 'Personal', label: 'Birth date', name: 'user.birth', type: 'date', value: NOW });
form.push({ group: 'Additional', label: 'Newsletter', name: 'user.newsletter', type: 'bool', value: true });
form.push({ group: 'Additional', label: 'City', name: 'user.city', type: 'list', value: 2, items: 'items', dirsearch: 'Search city', dircustom: true });
form.push({ group: 'Additional', label: 'Color', name: 'user.color', type: 'color', value: '#e73323' });
form.push({ group: 'Additional', label: 'Icon', name: 'user.icon', type: 'fontawesome', value: 'ti ti-home' });
form.push({ group: 'Additional', label: 'Emoji', name: 'user.emoji', type: 'emoji', value: '', show: 'n => n.age === 33' });

Vlastnosti údajov v deklarácii údajov:

name {String} identifikátor položky (vyžaduje sa)
label {String} označenie (vyžaduje sa)
group {String} názov skupiny (vyžaduje sa)
type {String} jeden typ (vyžaduje sa)
placeholder {String} jeden držiteľ miesta (podporuje len niekoľko typov)
transform {String} pre typ string môže obsahovať iba capitalize, uppercase, lowercase alebo slug
maxlength {Číslo} pre typ string len
validate {RegExp/String} pre typ string môže obsahovať iba email, phone alebo url
min {Číslo} pre typ number len
max {Číslo} pre typ number len
inc {Číslo/String} zvyšuje hodnotu podľa hodnoty, ktorá je zameraná na number alebo date (Môže obsahovať 1 day alebo -1 dayTyp iba
required {Boolean} pre typ string, number alebo date
dirsearch {String/Boolean} miesto držiteľ pre typ list len, boolean zabraňuje vyhľadávaniu
dircustom {Boolean} umožňuje nastavenú hodnotu pre typ list iba
dirkey {String} kľúčové meno pre značku/názov, určené len pre typ list (predvolené: name)
dirvalue {String} kľúčové meno pre hodnotu, určené len pre typ list (predvolené: id)
detail {String} URL pre získanie údajov pre typ list, napríklad: /users/{0}/ a {0} sa nahradí hodnotou z zoznamu
items {Object Array/String} položky pre typ list len, riadok môže obsahovať cestu do Array alebo URL address hľadať
show {Arrow funkcia}, príklad: data => data.KEY === 'SOMETHING' --> zobrazí položku, ak bude podmienka platná

Povolené typy v údajoch:

string
bool
number
date
list
color
emoji
fontawesome

Chýbajúce typy:

datetime
time
file
months

Trvalá móda

<ui-component name="properties" path="form" config="parent:window">
	<script type="text/html">
		[
			{ group: 'Personal', label: 'First name', name: 'firstname', type: 'string', transform: 'capitalize' },
			{ group: 'Personal', label: 'Last name', name: 'lastname', type: 'string', placeholder: 'String' },
			...
			...
			...
			{ group: 'Additional', label: 'Emoji', name: 'emoji', type: 'emoji', show: 'n => n.age === 33' }
		]
	</script>
</ui-component>

<script>
	var form = { firstname: 'John', lastname: 'Connor' };
</script>

Dobré vedieť

Komponent rozširuje pole pridaním:

invalid {Boolovské} pole určuje, či je value neplatné (predvolené: undefined)
Pole changed {Boolean} určuje, či sa zmenilo pole value (predvolené: undefined)
Pole prev {???} obsahuje počiatočnú hodnotu

Použite ho so <ui-component name="properties">. 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.

example.html

<ui-component name="LAZY directory"></ui-component>
<ui-component name="LAZY colorpicker"></ui-component>
<ui-component name="LAZY faicons"></ui-component>
<ui-component name="LAZY datepicker"></ui-component>
<ui-component name="LAZY timepicker"></ui-component>
<ui-component name="LAZY emoji"></ui-component>

<div style="width:400px;float:right">
	<ui-component name="properties" path="form" config="parent:window"></ui-component>
</div>

<script>
	var items = [{ id: 2, name: 'Banská Bystrica' }, { id: 3, name: 'Bratislava' }];
	var form = [];
	form.push({ group: 'Personal', label: 'First name', name: 'firstname', type: 'string', value: 'Peter', transform: 'capitalize' });
	form.push({ group: 'Personal', label: 'Last name', name: 'lastname', type: 'string', value: 'Širka', placeholder: 'String' });
	form.push({ group: 'Personal', label: 'Age', name: 'age', type: 'number', value: 33, min: 30 });
	form.push({ group: 'Personal', label: 'Birth date', name: 'birth', type: 'date', value: NOW });
	form.push({ group: 'Additional', label: 'Newsletter', name: 'newsletter', type: 'bool', value: true });
	form.push({ group: 'Additional', label: 'City', name: 'city', type: 'list', value: 2, items: 'items', dirsearch: 'Search city', dircustom: true });
	form.push({ group: 'Additional', label: 'Color', name: 'color', type: 'color', value: '#e73323' });
	form.push({ group: 'Additional', label: 'Icon', name: 'icon', type: 'fontawesome', value: 'ti ti-home' });
	form.push({ group: 'Additional', label: 'Emoji', name: 'emoji', type: 'emoji', value: '', show: 'n => n.age === 33' });
</script>