# j-ServerList

> BETA VERSION. Тази компонентна мрежа е предназначена за еднократни и корпоративни приложения.Той има почти същата функционалност като j-ServerGrid, но дава на разработчиците повече свобода да създават персонализиран ite

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

__BETA VERSION__. Тази компонентна мрежа е предназначена за еднократна страница и корпоративни приложения.Той постига същата функционалност като `j-ServerGrid`, но дава на разработчиците повече свобода да създават персонализиран елемент рендеринг.

__Data-Source__ трябва да съдържа:

```js
{
	columns: [
		{
			id: 'name',
			name: 'Name',
			width: 150, // optional (default: config.colwidth)
			filtering: false, // optional (default: false)
			sorting: false, // optional (default: false)
			align: 1, // optional: 0 or left (default), 1 or center, 2 or right
			alignheader: 1, // optional: 0 or left (default), 1 or center, 2 or right
			alignfilter: 1, // optional: 0 or left (default), 1 or center, 2 or right
			icon: 'ti ti-home', // optional: column icon
			dirsource: [{ id: 'String|Number|Boolean', name: '...' }] // optional: a dropdown filter (it needs "directory" component)
		}
	],
    items: [{ name: 'Row <b>1</b> will be bold', html: 'RENDER' }, { name: 'Row 2', html: 'RENDER' }, ...] // items
    page: 1,    // current pages
    pages: 30,  // count of pages
    limit: 5,   // items limit per page
    count: 150  // count of items in DB
}
```

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

- `colwidth {Number}` е стандартна ширина на колоната в пиксели (предварително: `150`)
- Плурализация на `pluralizepages {String}` за страници (опционално, по подразбиране: `# pages,# page,# pages,# pages`)
- Плурализация на `pluralizeitems {String}` за елементи (опционално, по подразбиране: `# items,# item,# items,# items`)
- `margin {Number}` е най-високата маржа за височина (опционално, по подразбиране: `0`)
- `noborder {Boolean}` може да премахне границата (предварително: `false`)
- `parent {String}` селектор за опция за височина `auto` (предварително: `window`)
- `height {Number}` фиксирана височина
- `filter {String}` е стандартно местоположение за всички филтри (опционално)
- `click {String}` - връзката към пътят или `function(row, row_element)`
- `exec {String}` е връзка към `function(type, filter, sort, page)` за операциите на сървъра (поддръжните видове: `filter`, `page` и `sort`)
- `display {Boolean}` позволява автоматично добавяне на jComponent отзивния клас `d-xs`, `d-lg`, и т.н. в зависимост от ширината на екрана (предварително: `true`)
- `empty {String}` е празна съобщение (предварително: `No records found.`)
- __NEW__: `scrollbarshadow {Boolean}` позволява скалбар сенка (предварително: `false`)
- __NEW__: `scrolltop {Boolean}` автоматично се върти в горната част след промяна на източника на данни (предварително: `true`)

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

- `NULL('link.to.data')` Оценка `config.exec`

## Където са шаблони

Схемата на сървъра се опитва да открие Tangular шаблон. ако един съществува, компонентът го използва. в противен случай той се опитва да направи съдържание от `html` собственост на всеки елемент/роу.

```html
<ui-component name="serverlist" ...>
	<script type="text/html">
		<!-- "value" represents each row -->
		<!-- "$" represents the entire datasource -->
		<div>{{ value.name }}</div>
	</script>
</ui-component>
```

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

```html example.html
<style>
	/* CUSTOM FORMATTING */
	.ui-serverlist-items { display: grid; column-gap: var(--gap); grid-template-columns: repeat(4, minmax(0,1fr)); padding: 20px; }
	.ui-serverlist-item { border: 2px solid #E0E0E0; padding: 10px; border-radius: 10px; }
	.ui-serverlist-check { position: absolute; margin: -20px 0 0 -20px; }
</style>

<ui-component name="serverlist" path="data" config="checkbox:1;height:500;exec:filtering">
	<script type="text/html">
		<div>{{ value.name }}, total pages: {{ $.pages }}</div>
	</script>
</ui-component>

<script id="datasource" type="text/json">
{
	"items": [
		{
			"id": "1",
			"name": "Hello world! 1",
			"createdby": "Peter Sirka",
			"dtcreated": "2024-11-25T22:43:53.455Z"
		},
		{
			"id": "2",
			"name": "Hello world! 2",
			"createdby": "Peter Sirka",
			"dtcreated": "2024-11-25T22:43:53.455Z"
		},
		{
			"id": "3",
			"name": "Hello world! 3",
			"createdby": "Peter Sirka",
			"dtcreated": "2024-11-25T22:43:53.455Z"
		}
	],
	"count": 1,
	"page": 2,
	"limit": 50,
	"pages": 3,
	"columns": [
		{
			"id": "name",
			"name": "Message",
			"icon": "ti ti-envelope",
			"filtering": true,
			"sorting": true
		},
		{
			"id": "createdby",
			"name": "Created by",
			"filtering": true,
			"sorting": true
		},
		{
			"id": "dtcreated",
			"name": "Created",
			"icon": "ti ti-calendar",
			"filtering": true,
			"sorting": true
		}
	]
}
</script>


<script>

	var data = PARSE('#datasource');

	function filtering(type, filter, sort, page) {
		console.log('Type:', type, 'Filter:', filter, 'Sort:', sort, 'Page:', page);
		UPD('data');
	}

</script>
```