j-Properties

jComponent 20 · jcomponent@20 component Exempel laddat med jComponent 20

Komponenten använder j-DatePicker, j-TimePicker, j-Directory, j-Emoji, j-ColorPicker och j-FaIcons komponenter.

Konfigurera:

dateformat {String} ett datumformat (default: yyyy-MM-dd)
timeformat {String} ett tidsformat (default: HH:mm)
datetimeformat {String} ett datum/tid format (default: yyyy-MM-dd HH:mm)
height {Numret} en höjd av elementet (default: undefined)
parent {String} jQuery-selektor för automatisk höjdinställning (kan vara window, parent eller custom)
margin {Number} vertikal marginal (default: 0)
change {String} en väg till metoden method(item, replace_text(new_text)) (exekveras om något värde ändras) och argumentet replace_text är valfritt
scrollbar {Boolean} aktiverar scrollbar (default: true)
visibleY {Boolean} visar en skruvbar (default: true)

Data deklaration:

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

Data egenskaper i dataklarationen:

name {String} ett objekt identifierare (krav)
label {String} en etikett (nödvändigt)
group {String} ett gruppnamn (behövs)
type {String} en typ (nödvändig)
placeholder {String} en platsinnehavare (stödjer bara få typer)
transform {String} för typ string endast, kan innehålla capitalize, uppercase, lowercase eller slug
maxlength {Numret} för typ string endast
validate {RegExp/String} för typ string endast, kan innehålla email, phone eller url
min {Numret} för typ number endast
max {Numret} för typ number endast
inc {Numret/String} ökar ett värde enligt det värde som är riktad mot number eller date (kan innehålla 1 day eller -1 dayTyp endast
required {Boolean} för typ string, number eller date
dirsearch {String/Boolean} en platsinnehavare för list typ endast, boolean inaktiverar sökning
dircustom {Boolean} tillåter ett anpassat värde för typ list endast
dirkey {String} ett nyckelnamn för etikett/namn, riktad endast till typ list (default: name)
dirvalue {String} ett nyckelnamn för värde, riktad endast till typ list (default: id)
detail {String} URL för att få data för list typ, exempel: /users/{0}/ och {0} ersätts med värdet från listan
items {Object Array/String} objekt för list typ endast, sträng kan innehålla en väg till Array eller URL address att söka
show {Arrow funktion}, exempel: data => data.KEY === 'SOMETHING' --> visar objektet om villkoret är giltigt

Tillåtna typer i data:

string
bool
number
date
list
color
emoji
fontawesome

Försvunna typer:

datetime
time
file
months

Hållbar 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>

Bra att veta

Komponenten utökar Array genom att lägga till:

invalid {Boolean} fält bestämmer om value är invalid (default: undefined)
changed {Boolean} fält bestämmer om value har ändrats (default: undefined)
prev {???} fält innehåller ett ursprungligt värde

Använd den med <ui-component name="properties">När komponenten ännu inte är laddad, jComponent Ladda ner den första gången från adressen i DEF.fallback (en av Componentator Författare: Peter Širka. källa: The Componentator Komponenterna i lager, MIT licens.

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>