# j-ServerGrid

> BETA-VERSION. Dieses Raster ist für Einzelseiten- und Unternehmensanwendungen konzipiert. Es ist eine einfache Alternative zum viel leistungsstärkeren j-DataGrid.

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

__BETA-VERSION__. Dieses Raster ist für Einzelseiten- und Unternehmensanwendungen konzipiert. Es ist eine einfache Alternative zum wesentlich leistungsstärkeren `j-DataGrid`.

__Datenquelle__ muss Folgendes enthalten:

```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
			color: '#000000' // optional: color for all rows,
			dirsource: [{ id: 'String|Number|Boolean', name: '...' }] // optional: a dropdown filter (it needs "directory" component)
		}
	],
    items: [{ name: 'Row <b>1</b> will be bold', $class: 'NEW: css class for the row', $style: 'NEW: css for the row' }, { name: 'Row 2' }, ...] // items
    page: 1,    // current pages
    pages: 30,  // count of pages
    limit: 5,   // items limit per page
    count: 150  // count of items in DB
}
```

__Konfiguration__:

- `colwidth {Number}` eine Standardspaltenbreite in Pixel (Standard: `150`)
- `pluralizepages {String}` Pluralisierung für Seiten (optional, Standard: `# pages,# page,# pages,# pages`)
- `pluralizeitems {String}` Pluralisierung für Elemente (optional, Standard: `# items,# item,# items,# items`)
- `margin {Number}` ein oberer Rand für die Höhe (optional, Standard: `0`)
- `noborder {Boolean}` kann einen Rand entfernen (Standard: `false`)
- `parent {String}`-Selektor für `auto`-Höhenoption (Standard: `window`)
- `height {Number}` eine feste Höhe
- `filter {String}` ein Standardplatzhalter für alle Filter (optional)
- `click {String}` ein Link zu einem Pfad oder `function(row, row_element)`
- `cell {String}` ein Link zu einem Pfad oder `function(row, cell_element, column)`
- `exec {String}` ein Link zu `function(type, filter, sort, page)` für serverseitige Vorgänge (unterstützte Typen: `filter`, `page` und `sort`)
- `opacity {Number}` eine Standard-Hintergrunddeckkraft für Spaltenfarben (Standard: `0.3`);
- __NEU__: `scrollbarshadow {Boolean}` aktiviert den Schatten der Bildlaufleiste (Standard: `false`)
- __NEU__: `scrolltop {Boolean}` scrollt automatisch nach oben, nachdem die Datenquelle geändert wurde (Standard: `true`)

__Gut zu wissen__:

- `NULL('link.to.data')` wertet `config.exec` aus

Verwenden Sie es mit `<ui-component name="servergrid">`. Wenn die Komponente noch nicht geladen ist, lädt jComponent sie bei der ersten Verwendung von der Adresse in `DEF.fallback` herunter (standardmäßig das CDN Componentator). Autor: Peter Širka. Quelle: Componentator-Komponenten-Repository, MIT-Lizenz.

```html example.html
<ui-component name="servergrid" path="data" config="checkbox:1;height:500;exec:filtering"></ui-component>

<script id="datasource" type="text/json">
{
	"items": [
		{
			"id": "IuX45p1cl61f",
			"name": "Hello world!",
			"createdby": "Peter Sirka",
			"dtcreated": "2024-11-25T22:43:53.455Z"
		}
	],
	"count": 1,
	"page": 2,
	"limit": 50,
	"pages": 3,
	"columns": [
		{
			"id": "name",
			"name": "Message",
			"width": 300,
			"color": "#F4E8E8",
			"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>
```