ForgeKomponenty
sk

Komponenty

j-Properties2

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-Icons.


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)
  • 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ý
  • Zarovnanie modalalign {String} pre modálne okná (predvolené: center)
  • style {Number} podporuje nový štýl 2 ako nastavenia iOS (predvolené: 1)
  • validation {Boolean} umožňuje overenie požadovaných polí (predvolené: true)
  • defaultgroup {String} predvolený názov skupiny (predvolené: Default)

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 (povinný)
  • label {String} štítok (povinný)
  • group {String} názov skupiny (povinné)
  • note {String} malá poznámka pod kontrolou
  • type {String} typ (povinné)
  • placeholder {String} zástupný symbol (podporuje len niekoľko typov)
  • transform {String} len pre typ string, môže obsahovať capitalize, uppercase, lowercase alebo slug
  • maxlength {Number} len pre typ string
  • validate {RegExp/String} len pre typ string, môže obsahovať email, phone alebo url
  • min {Number} len pre typ number
  • max {Number} len pre typ number
  • inc {Number/String} zvyšuje hodnotu podľa hodnoty, len pre typ number alebo date (môže obsahovať 1 day alebo -1 day)
  • required {Boolean} pre typ string, number alebo date
  • dirsearch {String/Boolean} je zástupný symbol len pre typ list, boolovská hodnota zakáže vyhľadávanie
  • dircustom {Boolean} umožňuje vlastnú hodnotu len pre typ list
  • dirkey {String} názov kľúča pre štítok/názov, určený len pre typ list (predvolené: name)
  • dirvalue {String} názov kľúča pre hodnotu, určený len pre typ list (predvolené: id)
  • detail {String} URL adresa na získanie údajov pre typ list, príklad: /users/{0}/ a {0} bude nahradená hodnotou zo zoznamu
  • Položky items {Object Array/String} len pre typ list, reťazec môže obsahovať cestu k Array alebo URL address na vyhľadávanie
  • show {Arrow function}, príklad: data => data.KEY === 'SOMETHING' --> zobrazí položku, ak bude podmienka platná
  • Ikona icon {String} Total, môže obsahovať farbu napr. ti ti-home #00000
  • ricon {String} Pravé písmo-Úžasná ikona alebo text, napr. !HTML text
  • riconclick {String} cesta k metóde function(item, set(new_val))
  • camouflage {Boolean} len pre typ string
  • monospace {Boolean} používa jednopriestorové písmo

Povolené typy v údajoch:

  • string
  • bool
  • number
  • date
  • list
  • color
  • emoji
  • fontawesome
  • exec (môže vykonať metódu exec)
  • text (hodnota len na čítanie)
  • menu (je to podobné ako v zozname, ale komponent vykoná j-Menu)

Chýbajúce typy:

  • datetime
  • time
  • file
  • months

Dobré vedieť

Komponent rozširuje pole pridaním:

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

Použite ho so <ui-component name="properties2">. 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>
<ui-component name="LAZY menu"></ui-component>

<div style="width:600px;padding:20px;background-color:#F0F0F0">

	<ui-component name="properties2" path="form" class="m"></ui-component>
	<ui-component name="properties2" path="form2" config="style:2" class="m"></ui-component>

	<!-- PERSISTENT MODE -->
	<ui-component name="properties2" path="form3" config="style:2">
		<script type="text/plain">
			[
				{ group: 'Personal', name: 'First name', id: 'firstname', type: 'string',transform: 'capitalize', note: 'Type your name' },
				{ group: 'Personal', name: 'Last name', id: 'lastname', type: 'string', placeholder: 'String' },
				{ group: 'Personal', name: 'Token', id: 'token', type: 'string', placeholder: 'String', camouflage: true }
			]
		</script>
	</ui-component>

</div>

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

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

	var form3 = {};
	form3.firstname = 'Peter';
	form3.lastname = 'Širka';
	form3.token = GUID(30);

	function myexec(item, el) {
		console.log(item, el);
	}

</script>