選取項目
自:Select 1.0.0 起
選取項目類型變更事件。
請注意 - 此屬性需要 DataTables 的 Select 擴充功能。
說明
每當要選取的項目(列、欄、儲存格)變更時,會觸發此事件。這可以使用 select.items
初始化選項或 select.items()
API 方法來完成。
請注意,與所有 DataTables 發出的事件一樣,此事件會使用 dt
命名空間觸發。因此,要偵聽此事件,您還必須使用 dt
命名空間,只需將 .dt
附加到您的事件名稱(在使用 on()
和 one()
時,會自動完成此操作)。
類型
function function( e, dt, items )
- 參數
名稱 類型 可選 1 e
否 jQuery 事件物件
2 dt
否 DataTables API 實例
3 items
否 最終使用者現在可選取的項目。請參閱
select.items
。
範例
每當項目選取類型變更時記錄
var table = new DataTable('#myTable');
table.on('selectItems', function (e, dt, items) {
console.log('Items to be selected are now: ', items);
});