ForgeКомпоненти
bg

Компоненти

j-Properties

jComponent 20 · jcomponent@20 component Примерът е зареден с jComponent 20

Съставът използва j-DatePicker, j-TimePicker, j-Directory, j-Emoji, j-ColorPicker и j-FaIcons компоненти.

Конфигуриране:

  • dateformat {String} формат за дата (предварително: yyyy-MM-dd)
  • timeformat {String} формат на времето (предварително: HH:mm)
  • datetimeformat {String} формат за дата/време (предварително: yyyy-MM-dd HH:mm)
  • height {No} височина на елемента (предварително: undefined)
  • parent {String} jQuery селектор за автоматично настройване на височината (може да бъде window, parent или custom)
  • margin Вертикална маржа (дефолт) 0)
  • change {String} е пътят към метода method(item, replace_text(new_text)) (извършен, ако се променя стойността) и аргументът replace_text е опционален
  • scrollbar {Boolean} позволява скалбар (предварително: true)
  • visibleY {Boolean} показва скалбар (дефолт: true)

Декларация за данни:

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

Собственост на данните в декларацията за данни:

  • name {String} идентификатор на елемента (необходим)
  • label {String} етикет (необходим)
  • group {String} име на групата (необходимо)
  • type {String} тип (необходим)
  • placeholder {String} един участник (поддържа само няколко вида)
  • transform {String} само за тип string, може да съдържа capitalize, uppercase, lowercase или slug
  • maxlength {No} за тип string само
  • validate {RegExp/String} само за тип string, може да съдържа email, phone или url
  • min {No} за тип number само
  • max {No} за тип number само
  • inc {Част/Стринг} увеличава стойността според стойността, насочена към number или date (Може да съдържа 1 day или -1 dayТипът само
  • required {Boolean} за тип string, number или date
  • dirsearch {String/Boolean} място за тип list само, Boolean прекъсва търсенето
  • dircustom {Boolean} позволява да се определи стойността само за типа list
  • dirkey {String} ключово име за етикет/име, насочено само към типа list (предварително: name)
  • dirvalue {String} ключово име за стойност, насочено само към типа list (предварително: id)
  • detail {String} URL адрес за получаване на данни за тип list, например: /users/{0}/ и {0} ще бъдат заменени с стойността от списъка
  • items {Object Array/String} елементи за тип list само, лентата може да съдържа път към Array или URL address за търсене
  • show {Arrow функция}, пример: data => data.KEY === 'SOMETHING' --> ще покаже елемента, ако условието е валидно

Допустими типове в данните:

  • string
  • bool
  • number
  • date
  • list
  • color
  • emoji
  • fontawesome

Изчезнали типове:

  • datetime
  • time
  • file
  • months

Постоянна мода

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

Добре е да се знае

Компонентът разширява Array, като добавя:

  • invalid {Boolean} полето определя дали value е невалиден (предварително: undefined)
  • changed {Boolean} полето определя дали value е променено (предварително: undefined)
  • prev {???} полето съдържа първоначална стойност

Използвайте го с <ui-component name="properties">Когато компонентът все още не е зареден, jComponent Изтегляне на първия адрес в DEF.fallback (След това Componentator Източник: Питър Шерка Componentator Съставни съставки, лиценз на 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>