j-Properties

jComponent 20 · jcomponent@20 component Exemplo carregado com jComponent 20

O componente usa j-DatePicker, j-TimePicker, j-Directory, j-Emoji, j-ColorPicker e j-FaIcons componentes.

Configuração:

dateformat {String} um formato de data (default: yyyy-MM-dd)
timeformat {String} um formato de tempo (default: HH:mm)
datetimeformat {String} um formato de data/tempo (default: yyyy-MM-dd HH:mm)
height {Número} uma altura do elemento (default: undefined)
parent {String} jQuery selector para auto-estação de altura (podem ser window, parent ou custom)
margin {Número} margem vertical (default: 0)
change {String} um caminho para o método method(item, replace_text(new_text)) (executado se algum valor for alterado) e o argumento replace_text é opcional
scrollbar {Boolean} permite o scrollbar (default: true)
visibleY {Boolean} mostra uma barra de rolamento (default: true)

Declaração de dados:

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

Propriedades de dados na declaração de dados:

name {String} um identificador de itens (necessário)
label {String} um rótulo (necessário)
group {String} um nome de grupo (necessário)
type {String} um tipo (necessário)
placeholder {String} um locatário (só suportam alguns tipos)
transform {String} para o tipo string apenas, pode conter capitalize, uppercase, lowercase ou slug
maxlength {Número} para o tipo string apenas
validate {RegExp/String} para o tipo string apenas, pode conter email, phone ou url
min {Número} para o tipo number apenas
max {Número} para o tipo number apenas
inc {Número/String} aumenta um valor de acordo com o valor, alvo para number ou date (Pode conter 1 day ou -1 dayTipo só
required {Boolean} para o tipo string, number ou date
dirsearch {String/Boolean} um locatário para o tipo list apenas, boolean desabilita a busca
dircustom {Boolean} permite um valor personalizado para o tipo list apenas
dirkey {String} um nome-chave para o rótulo/nome, destinado apenas ao tipo list (default: name)
dirvalue {String} um nome-chave para o valor, destinado apenas ao tipo list (default: id)
detail {String} URL para obter dados para list Tipo e exemplo: /users/{0}/ e {0} será substituído pelo valor da lista
items {Object Array/String} itens para o tipo list apenas, a fila pode conter um caminho para Array ou URL address para pesquisar
show {Arrow function}, exemplo: data => data.KEY === 'SOMETHING' --> mostrará o item se a condição será válida

Tipos permitidos em dados:

string
bool
number
date
list
color
emoji
fontawesome

Tipos desaparecidos:

datetime
time
file
months

Modo persistente

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

Bom para saber

O componente estende o Array adicionando:

O campo invalid {Boolean} determina se o value é invalido (default: undefined)
O campo changed {Boolean} determina se o value foi alterado (default: undefined)
prev contém um valor inicial

Use-o com <ui-component name="properties">Quando o componente ainda não está carregado, jComponent Descarrega-o no primeiro uso do endereço DEF.fallback (a partir do Componentator CDN por padrão). autor: Peter Širka. fonte: o Componentator Reserva de componentes, licença 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>

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