Bootstrap Table Ereignisse

Die Ereignisse-API von Bootstrap Table.

Ereignisse können auf zwei Arten gebunden werden:

• über das Optionsobjekt
• über den jQuery-Ereignishandler

Bindung über das Optionsobjekt:

// Hier können Sie erwarten, dass als letzten Parameter das bootstrap-table-Objekt übergeben wird

$('#table').bootstrapTable({
  onEventName: function (arg1, arg2, ...) {
    // ...
  }
})

Bindung über den jQuery-Ereignishandler:

// Hier können Sie im 'e'-Variablen die sender-Eigenschaft erwarten, die das bootstrap-table-Objekt ist

$('#table').on('event-name.bs.table', function (e, arg1, arg2, ...) {
  // ...
})

Hinweis: Wenn Sie den jQuery-Ereignishandler verwenden, stellen Sie sicher, dass Sie den Ereignislistener binden, bevor das Ereignis ausgeführt wird!

Anmerkung: Die unten stehenden Ereignisnamen (z. B. onCheck, onClickRow, onLoadSuccess) sind die genauen Ereignisnamen, die beim Binden von Ereignissen über JavaScript verwendet werden sollen.

onAll

• jQuery Event: all.bs.table

• Parameter: name, args

• Detail:

  Wird ausgelöst, wenn ein beliebiges Ereignis ausgelöst wird. Die Parameter enthalten:

  • name: der Ereignisname,
  • args: die Ereignisdaten.

onCheck

• jQuery Event: check.bs.table

• Parameter: row, $element

• Detail:

  Wird ausgelöst, wenn der Benutzer eine Zeile auswählt. Die Parameter enthalten:

  • row: der Datensatz, der der angeklickten Zeile entspricht.
  • $element: das markierte DOM-Element.

onCheckAll

• jQuery Event: check-all.bs.table

• Parameter: rowsAfter, rowsBefore

• Detail:

  Wird ausgelöst, wenn der Benutzer alle Zeilen auswählt. Die Parameter enthalten:

  • rowsAfter: Array von Datensätzen der jetzt ausgewählten Zeilen.
  • rowsBefore: Array von Datensätzen der vorher ausgewählten Zeilen.

onCheckSome

• jQuery Event: check-some.bs.table

• Parameter: rows

• Detail:

  Wird ausgelöst, wenn der Benutzer einige Zeilen auswählt. Die Parameter enthalten:

  • rows: Array von Datensätzen, die den neu ausgewählten Zeilen entsprechen.

onClickCell

• jQuery Event: click-cell.bs.table

• Parameter: field, value, row, $element

• Detail:

  Wird ausgelöst, wenn der Benutzer eine Zelle anklickt. Die Parameter enthalten:

  • field: der Feldname, der der angeklickten Zelle entspricht.
  • value: der Datenwert, der der angeklickten Zelle entspricht.
  • row: der Datensatz, der der angeklickten Zeile entspricht.
  • $element: das td-Element.

onClickRow

• jQuery Event: click-row.bs.table

• Parameter: row, $element, field

• Detail:

  Wird ausgelöst, wenn der Benutzer eine Zeile anklickt. Die Parameter enthalten:

  • row: der Datensatz, der der angeklickten Zeile entspricht.
  • $element: das tr-Element.
  • field: der Feldname, der der angeklickten Zelle entspricht.

onCollapseRow

• jQuery Event: collapse-row.bs.table

• Parameter: index, row, detailView

• Detail:

  Wird ausgelöst, wenn Sie das Detail-Icon klicken, um die Detailansicht einzuklappen. Die Parameter enthalten:

  • index: der Index der eingefahrenen Zeile.
  • row: der Datensatz, der der eingefahrenen Zeile entspricht.
  • detailView: die eingefahrene Detailansicht.

onColumnSwitch

• jQuery Event: column-switch.bs.table

• Parameter: field, checked

• Detail:

  Wird ausgelöst, wenn die Spaltensichtbarkeit umgeschaltet wird (showColumns). Die Parameter enthalten:

  • field: der Feldname, der der umgeschalteten Spalte entspricht.
  • checked: der aktivierte Zustand der Spalte.

onColumnSwitchAll

• jQuery Event: column-switch-all.bs.table

• Parameter: checked

• Detail:

  Wird ausgelöst, wenn alle Spalten umgeschaltet werden. Die Parameter enthalten:

  • checked: der aktivierte Zustand der Spalte.

onDblClickCell

• jQuery Event: dbl-click-cell.bs.table

• Parameter: field, value, row, $element

• Detail:

  Wird ausgelöst, wenn der Benutzer eine Zelle doppelt anklickt. Die Parameter enthalten:

  • field: der Feldname, der der angeklickten Zelle entspricht.
  • value: der Datenwert, der der angeklickten Zelle entspricht.
  • row: der Datensatz, der der angeklickten Zeile entspricht.
  • $element: das td-Element.

onDblClickRow

• jQuery Event: dbl-click-row.bs.table

• Parameter: row, $element, field

• Detail:

  Wird ausgelöst, wenn der Benutzer eine Zeile doppelt anklickt. Die Parameter enthalten:

  • row: der Datensatz, der der angeklickten Zeile entspricht.
  • $element: das tr-Element.
  • field: der Feldname, der der angeklickten Zelle entspricht.

onExpandRow

• jQuery Event: expand-row.bs.table

• Parameter: index, row, $detail

• Detail:

  Wird ausgelöst, wenn Sie das Detail-Icon klicken, um die Detailansicht zu erweitern. Die Parameter enthalten:

  • index: der Index der erweiterten Zeile.
  • row: der Datensatz, der der erweiterten Zeile entspricht.
  • $detail: das DOM-Element des Detail-div nach dem aktuellen tr-Element, Sie können jQuery-Methoden verwenden, um die Detailansichten anzupassen.

onLoadError

• jQuery Event: load-error.bs.table

• Parameter: status, jqXHR

• Detail:

  Wird ausgelöst, wenn beim Laden von Remote-Daten Fehler auftreten. Die Parameter enthalten:

  • status: der Statuscode von jqXHR.
  • jqXHR: jqXHR-Objekt, das eine Supermenge des XMLHTTPRequest-Objekts ist. Weitere Informationen finden Sie im jqXHR Type.

onLoadSuccess

• jQuery Event: load-success.bs.table

• Parameter: data

• Detail:

  Wird ausgelöst, wenn Remote-Daten erfolgreich geladen werden. Die Parameter enthalten:

  • data: die in die Tabelle geladenen Remote-Daten. (Hinweis: Diese Daten können nicht mehr geändert werden, sobald sie in die Tabelle geladen wurden. Wenn Sie empfangene Daten vor der Verwendung in der Tabelle verarbeiten müssen, schreiben Sie stattdessen Ihren benutzerdefinierten responseHandler.)
  • status: der Statuscode von jqXHR.
  • jqXHR: jqXHR-Objekt, das eine Supermenge des XMLHTTPRequest-Objekts ist. Weitere Informationen finden Sie im jqXHR Type.

onPageChange

• jQuery Event: page-change.bs.table

• Parameter: number, size

• Detail:

  Wird ausgelöst, wenn die Seitenzahl oder Seitengröße geändert wird. Die Parameter enthalten:

  • number: die Seitenzahl.
  • size: die Seitengröße.

onPostBody

• jQuery Event: post-body.bs.table

• Parameter: data

• Detail:

  Wird ausgelöst, nachdem der Tabellenkörper gerendert und im DOM verfügbar ist. Die Parameter enthalten:

  • data: die gerenderten Daten.

onPostFooter

• jQuery Event: post-footer.bs.table

• Parameter: $tableFooter

• Detail:

  Wird ausgelöst, nachdem die Fußzeile gerendert und im DOM verfügbar ist. Die Parameter enthalten:

  • $tableFooter: das DOM-Element der Fußzeile.

onPostHeader

• jQuery Event: post-header.bs.table

• Parameter: undefined

• Detail:

  Wird ausgelöst, nachdem der Tabellenkopf gerendert und im DOM verfügbar ist.

onPreBody

• jQuery Event: pre-body.bs.table

• Parameter: data

• Detail:

  Wird ausgelöst, bevor der Tabellenkörper gerendert wird. Die Parameter enthalten:

  • data: die gerenderten Daten.

onRefresh

• jQuery Event: refresh.bs.table

• Parameter: params

• Detail:

  Wird ausgelöst, nachdem der Aktualisierungsbutton geklickt wurde. Die Parameter enthalten:

  • params: die zusätzlichen Parameter, die an den Server gesendet werden.

onRefreshOptions

• jQuery Event: refresh-options.bs.table

• Parameter: options

• Detail:

  Wird ausgelöst, nachdem die Optionen aktualisiert wurden und bevor die Tabelle zerstört und initiiert wird. Die Parameter enthalten:

  • options: das Tabellenoptionsobjekt.

onResetView

• jQuery Event: reset-view.bs.table

• Parameter: undefined

• Detail:

  Wird ausgelöst, wenn die Ansicht der Tabelle zurückgesetzt wird.

onScrollBody

• jQuery Event: scroll-body.bs.table

• Parameter: $tableBody

• Detail:

  Wird ausgelöst, wenn der Tabellenkörper gescrollt wird.

onSearch

• jQuery Event: search.bs.table

• Parameter: text

• Detail:

  Wird ausgelöst, wenn die Tabelle durchsucht wird. Die Parameter enthalten:

  • text: der Text der Such eingabe.

onSort

• jQuery Event: sort.bs.table

• Parameter: name, order

• Detail:

  Wird ausgelöst, wenn der Benutzer eine Spalte sortiert. Die Parameter enthalten:

  • name: der Sortierspaltenfeldname.
  • order: die Sortierspaltenreihenfolge.

onToggle

• jQuery Event: toggle.bs.table

• Parameter: cardView

• Detail:

  Wird ausgelöst, wenn die Ansicht der Tabelle umgeschaltet wird. Die Parameter enthalten:

  • cardView: der CardView-Zustand der Tabelle.

onTogglePagination

• jQuery Event: toggle-pagination.bs.table

• Parameter: state

• Detail:

  Wird ausgelöst, wenn die Paginierung umgeschaltet wird:

  • state: der neue Paginierungsstatus (true-> Paginierung ist aktiviert, false -> Paginierung ist deaktiviert )

onUncheck

• jQuery Event: uncheck.bs.table

• Parameter: row, $element

• Detail:

  Wird ausgelöst, wenn der Benutzer eine Zeile abwählt. Die Parameter enthalten:

  • row: der Datensatz, der der angeklickten Zeile entspricht.
  • $element: das abgewahlte DOM-Element.

onUncheckAll

• jQuery Event: uncheck-all.bs.table

• Parameter: rowsAfter, rowsBefore

• Detail:

  Wird ausgelöst, wenn der Benutzer alle Zeilen abwählt. Die Parameter enthalten:

  • rowsAfter: Array von Datensätzen der jetzt ausgewählten Zeilen.
  • rowsBefore: Array von Datensätzen der vorher ausgewählten Zeilen.

onUncheckSome

• jQuery Event: uncheck-some.bs.table

• Parameter: rows

• Detail:

  Wird ausgelöst, wenn der Benutzer einige Zeilen abwählt. Die Parameter enthalten:

  • rows: Array von Datensätzen, die den zuvor ausgewählten Zeilen entsprechen.

onVirtualScroll

• jQuery Event: virtual-scroll.bs.table

• Parameter: startIndex, endIndex

• Detail:

  Wird ausgelöst, wenn der Benutzer am virtuellen Scrollen scrollt. Die Parameter enthalten:

  • startIndex: der Startzeilenindex des virtuellen Scrollens.
  • endIndex: der Endzeilenindex des virtuellen Scrollens.