Arbeiten mit Datatables

Datentabelle

Eine Datentabelle wird mit dem Objekt Alvine.Package.UI.Dialog.Datatable erstellt. Das Objekt enthält eine Vielzahl von Einstellmöglichkeiten. Eine Übersicht ist in der Dokumentation zur Console zu finden.

Der wichtigste Parameter ist die URL. Diese wird über die Einstellung data-url definiert und setzt sich aus dem API-Aufruf und verschiedenen Platzhaltern zusammen.

/api/.../search?q=${query}&orderby={orderby}&count=${count}&page=${page}

Die Platzhalter müssen folgendermaßen notiert werden: ${...}

Platzhalter Beschreibung
query Suchanfrage
orderby Sortierung
count Anzahl
offset Offset
page Seite

Soll gleich Ergebnisse angezeigt werden, so muss eine Standardabfrage definiert werden. Die Standard-Abfrage - wenn kein Filter gesetzt ist - wird über die Einstellung default-query übergeben. Meistens ist hier die Abfrage der ID

In der Konsole ist das Query-Argument für die übergabe an die API query, dies muss in Platform überschrieben werden. In den Optionen muss für den Schlüssel argument-query der Wert q gesetzt werden.

Werden im Schlüssel columns keine Spalten definiert, so werden alle Einträge aus dem zurückgegebenen Datensatz aus der ersten Zeile ausgewertet. Sollen die Spalten nicht automatisch hinzugefügt werden, so muss columns auf {} gesetzt werden.

Spalten können entweder als Zeichenkette oder als Objekt definiert werden. Wird eine Zeichenkette angegeben, so ist das der Schlüssel und das Label der Spalte. Über ein Objekt lassen sich die Einstellungen aus der Tabelle defifinieren.

Eigenschaft Beschreibung
label Tabellenüberschrift
fixed Spalte kann nicht ausgeblendet werden
visibility Sichtbarkeit
orderby Kann sortiert werden
css-class CSS-Klasse im TD
map Mapping
function Funktion
new Alvine.Package.UI.Dialog.Datatable({
        'data-url': '/my-api?q=${query}&orderby=${orderby}&count=${count}&page=${page}',
        'default-query': 'id>0',
        'argument-query': 'q',


    });

Wurde noch kein Filter ausgewählt, so muss eine Standardabfrage