取消选择
起始版本:Select 1.0.0
已取消选择项(行、列或单元格)。
请注意,此属性需要适用于 DataTables 的 Select 扩展。
描述
当 DataTables 中的项目(行、列或单元格)取消选择时,此事件将被触发,并提供有关取消选择的项目的相关信息。
请注意,出于性能原因,每个取消选择操作只会触发一个事件。结果是,如果在单个操作中取消选择了多个项目,那么每个取消选择的项目都不会收到自身事件,而取消选择的相关信息将以数组的形式传达。
此外,与所有 DataTables 发出的事件一样,此事件是使用 dt
命名空间触发的。因此,要侦听此事件,还必须使用 dt
命名空间,方法是将 .dt
附加到事件名称(在使用 on()
和 one()
时会自动执行此操作)。
类型
函数 函数(e, dt, type, indexes )
- 参数
名称 类型 可选 1 e
否 jQuery 事件对象
2 dt
否 DataTables API 实例
3 type
否 正在取消选择的项目。这可能是
行
、列
或者单元格
。4 indexes
否 取消选择项目的 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');
});