# j-Properties2

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

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

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__:

```javascript
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.

```html 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>
```