j-Properties

jComponent 20 · jcomponent@20 component Beispiel mit jComponent 20 geladen

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:

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

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

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>