Eventi di Bootstrap Table

L'API degli eventi di Bootstrap Table.

Gli eventi possono essere legati in due modi:

• tramite l’oggetto opzioni
• tramite il gestore eventi jquery

Binding tramite l’oggetto opzioni:

// Qui, puoi aspettarti di avere come ultimo parametro l'oggetto bootstrap-table

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

Binding tramite il gestore eventi jquery:

// Qui, puoi aspettarti di avere nella variabile 'e' la proprietà sender, che è l'oggetto bootstrap-table

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

Suggerimento: se utilizzi il gestore eventi jquery, assicurati di legare il listener dell’evento prima che l’evento venga eseguito!

Nota: I nomi degli eventi qui sotto (ad esempio, onCheck, onClickRow, onLoadSuccess) sono nomi di eventi esatti da utilizzare quando si legano eventi tramite JavaScript.

onAll

• Evento jQuery: all.bs.table

• Parametro: name, args

• Dettagli:

  Si attiva quando viene attivato qualsiasi evento. I parametri contengono:

  • name: il nome dell’evento,
  • args: i dati dell’evento.

onCheck

• Evento jQuery: check.bs.table

• Parametro: row, $element

• Dettagli:

  Si attiva quando l’utente seleziona una riga. I parametri contengono:

  • row: il record corrispondente alla riga cliccata.
  • $element: l’elemento DOM selezionato.

onCheckAll

• Evento jQuery: check-all.bs.table

• Parametro: rowsAfter, rowsBefore

• Dettagli:

  Si attiva quando l’utente seleziona tutte le righe. I parametri contengono:

  • rowsAfter: array di record delle righe ora selezionate.
  • rowsBefore: array di record delle righe selezionate in precedenza.

onCheckSome

• Evento jQuery: check-some.bs.table

• Parametro: rows

• Dettagli:

  Si attiva quando l’utente seleziona alcune righe. I parametri contengono:

  • rows: array di record corrispondenti alle righe recentemente selezionate.

onClickCell

• Evento jQuery: click-cell.bs.table

• Parametro: field, value, row, $element

• Dettagli:

  Si attiva quando l’utente clicca una cella. I parametri contengono:

  • field: il nome del campo corrispondente alla cella cliccata.
  • value: il valore dei dati corrispondente alla cella cliccata.
  • row: il record corrispondente alla riga cliccata.
  • $element: l’elemento td.

onClickRow

• Evento jQuery: click-row.bs.table

• Parametro: row, $element, field

• Dettagli:

  Si attiva quando l’utente clicca una riga. I parametri contengono:

  • row: il record corrispondente alla riga cliccata.
  • $element: l’elemento tr.
  • field: il nome del campo corrispondente alla cella cliccata.

onCollapseRow

• Evento jQuery: collapse-row.bs.table

• Parametro: index, row, detailView

• Dettagli:

  Si attiva quando si clicca l’icona dei dettagli per comprimere la vista dettagliata. I parametri contengono:

  • index: l’indice della riga compressa.
  • row: il record corrispondente alla riga compressa.
  • detailView: la vista dettagliata compressa.

onColumnSwitch

• Evento jQuery: column-switch.bs.table

• Parametro: field, checked

• Dettagli:

  Si attiva quando si cambia la visibilità della colonna (showColumns). I parametri contengono:

  • field: il nome del campo corrispondente alla colonna commutata.
  • checked: lo stato di selezione della colonna.

onColumnSwitchAll

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

• Parametro: checked

• Dettagli:

  Si attiva quando si alternano tutte le colonne. I parametri contengono:

  • checked: lo stato di selezione della colonna.

onDblClickCell

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

• Parametro: field, value, row, $element

• Dettagli:

  Si attiva quando l’utente fa doppio clic su una cella. I parametri contengono:

  • field: il nome del campo corrispondente alla cella cliccata.
  • value: il valore dei dati corrispondente alla cella cliccata.
  • row: il record corrispondente alla riga cliccata.
  • $element: l’elemento td.

onDblClickRow

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

• Parametro: row, $element, field

• Dettagli:

  Si attiva quando l’utente fa doppio clic su una riga. I parametri contengono:

  • row: il record corrispondente alla riga cliccata.
  • $element: l’elemento tr.
  • field: il nome del campo corrispondente alla cella cliccata.

onExpandRow

• Evento jQuery: expand-row.bs.table

• Parametro: index, row, $detail

• Dettagli:

  Si attiva quando si clicca l’icona dei dettagli per espandere la vista dettagliata. I parametri contengono:

  • index: l’indice della riga espansa.
  • row: il record corrispondente alla riga espansa.
  • $detail: l’elemento DOM del div dei dettagli dopo l’elemento tr corrente, è possibile utilizzare i metodi jQuery per personalizzare le viste dettagliate.

onLoadError

• Evento jQuery: load-error.bs.table

• Parametro: status, jqXHR

• Dettagli:

  Si attiva quando si verificano errori durante il caricamento dei dati remoti. I parametri contengono:

  • status: il codice di stato di jqXHR.
  • jqXHR: oggetto jqXHR, che è un super set dell’oggetto XMLHTTPRequest. Per ulteriori informazioni, vedere il Tipo jqXHR.

onLoadSuccess

• Evento jQuery: load-success.bs.table

• Parametro: data

• Dettagli:

  Si attiva quando i dati remoti vengono caricati correttamente. I parametri contengono:

  • data: i dati remoti caricati nella tabella. (Nota: questi dati non possono essere modificati una volta caricati nella tabella. Se è necessario elaborare i dati ricevuti prima di utilizzarli nella tabella, scrivi il tuo responseHandler personalizzato invece.)
  • status: il codice di stato di jqXHR.
  • jqXHR: oggetto jqXHR, che è un super set dell’oggetto XMLHTTPRequest. Per ulteriori informazioni, vedere il Tipo jqXHR.

onPageChange

• Evento jQuery: page-change.bs.table

• Parametro: number, size

• Dettagli:

  Si attiva quando si cambia il numero di pagina o la dimensione della pagina. I parametri contengono:

  • number: il numero di pagina.
  • size: la dimensione della pagina.

onPostBody

• Evento jQuery: post-body.bs.table

• Parametro: data

• Dettagli:

  Si attiva dopo che il corpo della tabella è stato renderizzato e disponibile nel DOM. I parametri contengono:

  • data: i dati renderizzati.

onPostFooter

• Evento jQuery: post-footer.bs.table

• Parametro: $tableFooter

• Dettagli:

  Si attiva dopo che il piè di tabella è stato renderizzato e disponibile nel DOM. I parametri contengono:

  • $tableFooter: l’elemento DOM del piè di tabella.

onPostHeader

• Evento jQuery: post-header.bs.table

• Parametro: undefined

• Dettagli:

  Si attiva dopo che l’intestazione della tabella è stata renderizzata e disponibile nel DOM.

onPreBody

• Evento jQuery: pre-body.bs.table

• Parametro: data

• Dettagli:

  Si attiva prima che il corpo della tabella sia renderizzato. I parametri contengono:

  • data: i dati renderizzati.

onRefresh

• Evento jQuery: refresh.bs.table

• Parametro: params

• Dettagli:

  Si attiva dopo il clic del pulsante di aggiornamento. I parametri contengono:

  • params: i parametri aggiuntivi richiesti al server.

onRefreshOptions

• Evento jQuery: refresh-options.bs.table

• Parametro: options

• Dettagli:

  Si attiva dopo aver aggiornato le opzioni e prima di distruggere e inizializzare la tabella. I parametri contengono:

  • options: l’oggetto delle opzioni della tabella.

onResetView

• Evento jQuery: reset-view.bs.table

• Parametro: undefined

• Dettagli:

  Si attiva quando si reimposta la vista della tabella.

onScrollBody

• Evento jQuery: scroll-body.bs.table

• Parametro: $tableBody

• Dettagli:

  Si attiva quando il corpo della tabella viene fatto scorrere.

onSearch

• Evento jQuery: search.bs.table

• Parametro: text

• Dettagli:

  Si attiva quando si cerca nella tabella. I parametri contengono:

  • text: il testo dell’input di ricerca.

onSort

• Evento jQuery: sort.bs.table

• Parametro: name, order

• Dettagli:

  Si attiva quando l’utente ordina una colonna. I parametri contengono:

  • name: il nome del campo della colonna ordinata.
  • order: l’ordine della colonna ordinata.

onToggle

• Evento jQuery: toggle.bs.table

• Parametro: cardView

• Dettagli:

  Si attiva quando si alterna la vista della tabella. I parametri contengono:

  • cardView: lo stato di cardView della tabella.

onTogglePagination

• Evento jQuery: toggle-pagination.bs.table

• Parametro: state

• Dettagli:

  Si attiva quando la paginazione viene alternata:

  • state: il nuovo stato della paginazione (true-> Paginazione abilitata, false -> Paginazione disabilitata )

onUncheck

• Evento jQuery: uncheck.bs.table

• Parametro: row, $element

• Dettagli:

  Si attiva quando l’utente deseleziona una riga. I parametri contengono:

  • row: il record corrispondente alla riga cliccata.
  • $element: l’elemento DOM deselezionato.

onUncheckAll

• Evento jQuery: uncheck-all.bs.table

• Parametro: rowsAfter, rowsBefore

• Dettagli:

  Si attiva quando l’utente deseleziona tutte le righe. I parametri contengono:

  • rowsAfter: array di record delle righe ora selezionate.
  • rowsBefore: array di record delle righe selezionate in precedenza.

onUncheckSome

• Evento jQuery: uncheck-some.bs.table

• Parametro: rows

• Dettagli:

  Si attiva quando l’utente deseleziona alcune righe. I parametri contengono:

  • rows: array di record corrispondenti alle righe precedentemente selezionate.

onVirtualScroll

• Evento jQuery: virtual-scroll.bs.table

• Parametro: startIndex, endIndex

• Dettagli:

  Si attiva quando l’utente fa scorrere lo scroll virtuale. I parametri contengono:

  • startIndex: l’indice di inizio della riga dello scroll virtuale.
  • endIndex: l’indice di fine della riga dello scroll virtuale.