j-Properties

jComponent 20 · jcomponent@20 component Ejemplo cargado con jComponent 20

El componente utiliza componentes j-DatePicker, j-TimePicker, j-Directory, j-Emoji, j-ColorPicker y j-FaIcons.

Configuración:

dateformat {String} un formato de fecha (predeterminado: yyyy-MM-dd)
timeformat {String} un formato de hora (predeterminado: HH:mm)
datetimeformat {String} un formato de fecha/hora (predeterminado: yyyy-MM-dd HH:mm)
height {Número} una altura del elemento (predeterminado: undefined)
parent {String} selector jQuery para configuración automática de altura (puede ser window, parent o custom)
margin {Número} margen vertical (predeterminado: 0)
change {String} una ruta al método method(item, replace_text(new_text)) (se ejecuta si se cambia algún valor) y el argumento replace_text es opcional
scrollbar {Booleano} habilita la barra de desplazamiento (predeterminado: true)
visibleY {Booleano} muestra una barra de desplazamiento (predeterminado: true)

Declaración de datos:

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

Propiedades de datos en la declaración de datos:

name {String} un identificador de artículo (obligatorio)
label {Cadena} una etiqueta (obligatoria)
group {String} un nombre de grupo (obligatorio)
type {Cadena} un tipo (obligatorio)
placeholder {String} un marcador de posición (solo admite algunos tipos)
transform {String} solo para el tipo string, puede contener capitalize, uppercase, lowercase o slug
maxlength {Número} solo para el tipo string
validate {RegExp/String} solo para el tipo string, puede contener email, phone o url
min {Número} solo para el tipo number
max {Número} solo para el tipo number
inc {Número/Cadena} incrementa un valor según el valor, destinado al tipo number o date (puede contener 1 day o -1 day)
required {Booleano} para tipo string, number o date
dirsearch {String/Boolean} un marcador de posición solo para el tipo list, booleano deshabilita la búsqueda
dircustom {Booleano} habilita un valor personalizado solo para el tipo list
dirkey {String} un nombre clave para etiqueta/nombre, dirigido solo al tipo list (predeterminado: name)
dirvalue {String} un nombre de clave para el valor, dirigido solo al tipo list (predeterminado: id)
detail {String} Dirección URL para obtener datos para el tipo list, ejemplo: /users/{0}/ y {0} se reemplazarán con el valor de la lista
items {Object Array/String} elementos solo para el tipo list, la cadena puede contener una ruta a Array o URL address para buscar
show {Función de flecha}, ejemplo: data => data.KEY === 'SOMETHING' --> mostrará el artículo si la condición es válida

Tipos permitidos en datos:

string
bool
number
date
list
color
emoji
fontawesome

Tipos faltantes:

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>

Es bueno saberlo

El componente extiende el Array agregando:

El campo invalid {Booleano} determina si value no es válido (predeterminado: undefined)
El campo changed {Booleano} determina si se ha cambiado el value (predeterminado: undefined)
prev {???} el campo contiene un valor inicial

Úselo con <ui-component name="properties">. Cuando el componente aún no está cargado, jComponent lo descarga en el primer uso desde la dirección en DEF.fallback (el CDN Componentator de forma predeterminada). Autor: Peter Širka. Fuente: repositorio de componentes Componentator, licencia 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>