取消選取

自：Select 1.0.0 版本起

項目（列、欄或儲存格）已取消選取。
請注意 - 此屬性需要 DataTables 的 Select 擴充套件。

描述

每當在 DataTable 中取消選取項目（列、欄或儲存格）時，就會觸發此事件，並提供有關已取消選取的項目資訊。

請注意，基於效能考量，每次取消選取動作只會觸發單一事件。結果是，如果在單一動作中取消選取多個項目，則每個取消選取的項目不會收到自己的事件，而是將有關取消選取項目的資訊傳遞到陣列中。

此外，與所有 DataTables 發出的事件一樣，此事件會以 dt 命名空間觸發。因此，若要監聽此事件，您也必須使用 dt 命名空間，只需將 .dt 附加到您的事件名稱即可（當使用 on() 和 one() 時，會自動執行此操作）。

類型

function function( e, dt, type, indexes )

參數

	名稱	類型	選填
1	`e`	`object`	否
	jQuery 事件物件
2	`dt`	`DataTables.Api`	否
	DataTables API 實例
3	`type`	`string`	否
	正在取消選取的項目。這可以是 `row`、`column` 或 `cell`。
4	`indexes`	`array`	否
	已取消選取項目的 DataTables 索引。這可以與表格選取器方法一起使用（例如 `rows()`）。有關 DataTables 使用的項目索引的更多資訊，請參閱 `row().index()`、`column().index()` 和 `cell().index()`（如適用）。

範例

當列取消選取時，從列取得資料

var table = new DataTable('#myTable');

table.on('deselect', function (e, dt, type, indexes) {
	if (type === 'row') {
		var data = table
			.rows(indexes)
			.data()
			.pluck('id');

		// do something with the ID of the deselected items
	}
});

當項目取消選取時，移除自訂類別

var table = new DataTable('#myTable');

table.on('deselect', function (e, dt, type, indexes) {
	table[type](indexes)
		.nodes()
		.to$()
		.removeClass('custom-selected');
});