# j-Properties

> Die Komponente verwendet die Komponenten j-DatePicker, j-TimePicker, j-Directory, j-Emoji, j-ColorPicker und j-FaIcons.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: de
Content-SHA256: 63af9110bffe7b96c4c7b09a09266e8328b60cdbfb27855c3f0b08950331a538
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Die Komponente verwendet die Komponenten `j-DatePicker`, `j-TimePicker`, `j-Directory`, `j-Emoji`, `j-ColorPicker` und `j-FaIcons`.

__Konfiguration__:

- `dateformat` {String} ein Datumsformat (Standard: `yyyy-MM-dd`)
- `timeformat` {String} ein Zeitformat (Standard: `HH:mm`)
- `datetimeformat` {String} ein Datums-/Uhrzeitformat (Standard: `yyyy-MM-dd HH:mm`)
- `height` {Zahl} eine Höhe des Elements (Standard: `undefined`)
- `parent` {String} jQuery-Selektor für die automatische Einrichtung der Höhe (kann `window`, `parent` oder `custom` sein)
- `margin` {Number} vertikaler Rand (Standard: `0`)
- `change` {String} ein Pfad zur Methode `method(item, replace_text(new_text))` (wird ausgeführt, wenn ein Wert geändert wird) und das Argument `replace_text` ist optional
- `scrollbar` {Boolean} aktiviert die Bildlaufleiste (Standard: `true`)
- `visibleY` {Boolean} zeigt eine Bildlaufleiste an (Standard: `true`)

__Datendeklaration__:

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

__Dateneigenschaften in der Datendeklaration__:
- `name` {String} ein Element identifizierer (bedarf)
- `label` {String} ein Etikett (erfordert)
- `group` {String} ein Gruppenname (bedarf)
- `type` {String} eine Art (erfordert)
- `placeholder` {String} ein Platzinhaber (unterhält nur wenige Arten)
- `transform` {String} für den Typ `string` nur, kann `capitalize`, `uppercase`, `lowercase` oder `slug` enthalten
- `maxlength` {Nummer} für den Typ `string` nur
- `validate` {RegExp/String} für den Typ `string` nur, kann `email`, `phone` oder `url` enthalten
- `min` {Nummer} für den Typ `number` nur
- `max` {Nummer} für den Typ `number` nur
- `inc` {Nummer/String} erhöht einen Wert nach dem Wert, der für `number` oder `date` kann enthalten `1 day` oder `-1 day`Typ nur
- `required` {Boolean} für den Typ `string`, `number` oder `date`
- `dirsearch` {String/Boolean} ein Platzinhaber für `list` Typ nur, Boolean verhindert Suche
- `dircustom` {Boolean} ermöglicht eine angepasste Wert für den Typ `list` nur
- `dirkey` {String} ein Schlüsselnamen für das Etikett/Name, nur für den Typ `list` gerichtet (Default: `name`)
- `dirvalue` {String} ein Schlüsselnamen für den Wert, nur für den Typ `list` gerichtet (Default: `id`)
- `detail` {String} URL für die Erfassung von Daten für `list` Typ, zum Beispiel: `/users/{0}/` und `{0}` wird durch den Wert aus der Liste ersetzt
- `items` {Object Array/String} Elemente für Typ `list` nur, String kann einen Weg nach `Array` oder `URL address` zu suchen enthalten
- `show` {Arrow Funktion}, Beispiel: `data => data.KEY === 'SOMETHING'` --> zeigt das Element an, ob die Bedingung gültig ist

__Zulässige Typen in Daten__:

- `string`
- `bool`
- `number`
- `date`
- `list`
- `color`
- `emoji`
- `fontawesome`

__Fehlende Typen__:

- `datetime`
- `time`
- `file`
- `months`

### Dauerhafte Mode

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

### Gut zu wissen

Die Komponente erweitert das Array um Folgendes:

- Das Feld `invalid` {Boolean} bestimmt, ob `value` ungültig ist (Standard: `undefined`).
- Das Feld `changed` {Boolean} bestimmt, ob `value` geändert wurde (Standard: `undefined`).
- Das Feld `prev` {???} enthält einen Anfangswert

Verwenden Sie es mit `<ui-component name="properties">`. Wenn die Komponente noch nicht geladen ist, lädt jComponent sie bei der ersten Verwendung von der Adresse in `DEF.fallback` herunter (standardmäßig das CDN Componentator). Autor: Peter Širka. Quelle: Componentator-Komponenten-Repository, MIT-Lizenz.

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

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