# j-Detail

> Този компонент може да възпроизвежда стойности от модела. Подпомага инлайн мапиране - погледнете в източния код на примера.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: bg
Content-SHA256: be758d668c78c5c3ef70618be8deec335bbcef563a5f44ad08a741aef1fb7fc9
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

Този компонент може да възпроизвежда стойности от модела. Подпомага инлайн мапиране - погледнете в източния код на примера.


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

- `dateformat {String}` - формат за дата (предварително: `DEF.dateformat`)
- `datetimeformat {String}` - формат за дата и време (предварително: `DEF.dateformat + ' ' + DEF.timeformat`)
- `numberformat {Number}` - формат за изчислено число (изчислена: празна)
- `small {Boolean}` позволява по-малък дизайн (предварително: `false`)
- Стилът на компонентите `style {Number}` (предварително: `1`), поддържат стиловете `2`, `3` (минимално) и `4` (модерни)
- `defaultgroup {String}` е подразбиране на групата (предварително: `Default`)
- `notnull {Boolean}` нива на нулеви стойности (дефолт: `false`)
- `track {String}` може да съдържа пътеки, разделени от comma, тази собственост ще наблюдава само промените в привличаните ключове

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

```javascript
var model = { firstname: 'Peter', lastname: 'Širka', age: 33 };
var items = [{ id: 2, name: 'Banská Bystrica' }, { id: 3, name: 'Bratislava' }];
var form = [];

// The below values will be binded automatically from the "model" (according to the "path" field) because they contain "path" field
form.push({ group: 'Personal', label: 'First name', path: 'firstname', type: 'string', value: model, note: 'This is first name' });
form.push({ group: 'Personal', label: 'Last name', path: 'lastname', type: 'string', value: model, placeholder: 'String' });
form.push({ group: 'Personal', label: 'Age', path: 'age', type: 'number', value: model });

// The below values will be binded from "value" key
form.push({ group: 'Personal', label: 'Birth date', type: 'date', value: NOW });
form.push({ group: 'Additional', label: 'Newsletter', type: 'bool', value: true });
form.push({ group: 'Additional', label: 'City', type: 'list', value: 2, items: 'items' });
form.push({ group: 'Additional', label: 'Color', type: 'color', value: '#e73323' });
form.push({ group: 'Additional', label: 'Icon', type: 'fontawesome', value: 'fas fa-home' });
```

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

- `group {String}` - група име (необходимо)
- `label {String}` етикет (необходима)
- `type {String}` тип (необходим)
- `note {String}` - малка нота под стойност
- `format {String}` номер, например `2` или дата формат `dd.MM.yyyy`
- `detail {String}` URL адрес за получаване на данни за `list` Тип и пример: `/users/{0}/` и `{0}` ще бъде заменен с стойността от списъка
- Елементи на `items {Object Array/String}` за тип `list` само, редове могат да съдържат път към `Array` или `URL address` за търсене
- `value {Object}` е стойност или модел с стойности (тогава `path` се изисква)
- `path {String}` - път към стойност в модела (`value` трябва да съдържа модел)
- `template {String}` A Tangular шаблон (работи само с `type:'template'` и `{{ value }}` съдържа сурова стойност, а `{{ item }}` съдържа целия елемент)
- `empty {String}` Празна стойност, когато стойността е нулева (предварително: `---`)
- `show {String}` Условителната функция `value.type === 'company'` Това означава, че оценяването на състоянието е `true`
- __NEW__ `autoformat {Boolean}` позволява автоматичен формат за `email`, или `phones`, и само за тип `string` (предварително: `false`)
- __NEW__ `colorize {Boolean}` оцветява стойността с изключение на типа `list`, `color` и `icon`
- __NEW__ `plus {String}` добавя стойност към края на преработената стойност за типове `number` и `string`

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

- `string`
- `bool`
- `number`
- `date`
- `datetime`
- `list`
- `color`
- `emoji`
- `fontawesome`
- `password`
- `template`

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

- Ако групата съдържа само един танк, тогава името на групата не се представя

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

```html example.html
<div style="width:500px">
	<ui-component name="detail" path="form"></ui-component>
	<br />
	<div>-- OR --</div>
	<br />
	<ui-component name="detail" path="model" config="style:2">
		<script type="text/plain">
			[
				{ name: 'First name', path: 'firstname', type: 'string' },
				{ name: 'Last name', path: 'lastname', type: 'string' },
				{ name: 'Age', path: 'age', type: 'number' }
			]
		</script>
	</ui-component>
	<br />
	<div>-- OR FILTERED --</div>
	<br />
	<ui-component name="detail" path="model" config="style:3">
		<script type="text/plain">
			[
				// Will be displayed, look to show condition ("value" means "model")
				{ name: 'First name', path: 'firstname', type: 'string', show: 'value.type==1' },
				{ name: 'Last name', path: 'lastname', type: 'string', show: 'value.type==1' },
				// Won't be displayed, look to show condition ("value" means "model")
				{ name: 'Age', path: 'age', type: 'number', show: 'value.type==2' }
			]
		</script>
	</ui-component>
	<br />
	<ui-component name="detail" path="model" config="style:4">
		<script type="text/plain">
			[
				// Will be displayed, look to show condition ("value" means "model")
				{ name: 'First name', path: 'firstname', type: 'string', show: 'value.type==1' },
				{ name: 'Last name', path: 'lastname', type: 'string', show: 'value.type==1' },
				// Won't be displayed, look to show condition ("value" means "model")
				{ name: 'Age', path: 'age', type: 'number', show: 'value.type==2' }
			]
		</script>
	</ui-component>
</div>

<script>
	var model = { firstname: 'Peter', lastname: 'Širka', age: 33, type: 1 };
	var items = [{ id: 2, name: 'Banská Bystrica' }, { id: 3, name: 'Bratislava' }];
	var form = [];

	// The below values will be binded automatically from the "model" (according to the "path" field) because they contain "path" field
	form.push({ group: 'Personal', label: 'First name', path: 'firstname', type: 'string', value: model, note: 'This is first name' });
	form.push({ group: 'Personal', label: 'Last name', path: 'lastname', type: 'string', value: model, placeholder: 'String' });
	form.push({ group: 'Personal', label: 'Age', path: 'age', type: 'number', value: model });

	// The below values will be binded from "value" key
	form.push({ group: 'Personal', label: 'Birth date', type: 'date', value: NOW });
	form.push({ group: 'Additional', label: 'Newsletter', type: 'bool', value: true });
	form.push({ group: 'Additional', label: 'City', type: 'list', value: 2, items: 'items' });
	form.push({ group: 'Additional', label: 'Color', type: 'color', value: '#e73323' });
	form.push({ group: 'Additional', label: 'Icon', type: 'fontawesome', value: 'ti ti-home' });
</script>
```
