j-ServerList

jComponent 20 · jcomponent@20 component Beispiel mit jComponent 20 geladen

BETA-VERSION. Diese Komponente ist für Einzelseiten- und Unternehmensanwendungen konzipiert. Sie verfügt über nahezu die gleiche Funktionalität wie j-ServerGrid, bietet Entwicklern jedoch mehr Freiheit bei der Erstellung benutzerdefinierter Elementdarstellungen.

Datenquelle muss Folgendes enthalten:

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

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)
exec {String} ein Link zu function(type, filter, sort, page) für serverseitige Vorgänge (unterstützte Typen: filter, page und sort)
display {Boolean} ermöglicht das automatische Hinzufügen der jComponent-Reaktionsklassen d-xs, d-lg usw. entsprechend der Bildschirmbreite (Standard: true)
empty {String} eine leere Nachricht (Standard: No records found.)
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

Benutzerdefinierte Vorlagen

Die ServerList-Komponente versucht, eine Tangular-Vorlage zu finden. Wenn einer vorhanden ist, wird er von der Komponente verwendet. Andernfalls wird versucht, einen Inhalt aus der html-Eigenschaft jedes Elements/jeder Zeile zu rendern.

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

Verwenden Sie es mit <ui-component name="serverlist">. 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.

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>