Mit diesem Kommando kann eine Schaltfläche in die Navigatorleiste eines Tabellengitters eingefügt werden. Der Schaltfläche kann entweder mit einer Beschriftung oder einem Symbol versehen werden. Mit den Kommandos „Aktion verknüpfen“ können dann später Aktionen mit den Schaltflächen verknüpft werden.
Parameter:
- ID: (optional) Eine Eindeutige ID der Schaltfläche, wird zur Verknüpfung mit Aktionen benötigt.
- Beschriftung: (optional) Wird eine Beschriftung angegeben, wird diese angezeigt.
- Tooltip: (optional) Ein Tooltip für die Schaltfläche.
- Symbolname (ui-icon-xyz): (optional) Es wird das entsprechende Symbol angezeigt. Eine Liste aller mitgelieferten Symbolnamen findet sich unter jqueryui.com/themeroller/ am unteren Ende der Seite. Eigene Symbole können über CSS definiert werden. Möglich ist auch die Einbindung der Font-Awesome Icons, dazu muss zuerst der Klassenname dle-font-awesome-icon und dann der Klassenname des gewünschten Icons angegeben werden, z.B. icon-bell. Je nach gewähltem Look-And-Feel ist es dann eventuell nötig, noch die Farbe des Icons über eine Klasse anzupassen.
- Position: (optional) Zuerst oder Zuletzt, bestimmt wo die Schaltfläche eingeordnet werden soll.
- Cursorname: (optional) Name des Mauszeigersymbols für diese Schaltfläche. Wird kein Name angegeben, wird der Default Cursor verwendet.
- Aktiv wenn Zeile selektiert: (optional) Bei Ja ist die Schaltfläche nur sichtbar, wenn eine Zeile in der Tabelle selektiert ist. Eine feinere Steuerung der Sichtbarkeit ist später in den Tabellendaten möglich. Dort können je nach Dateninhalt bestimmte Schaltflächen sichtbar gemacht werden.