选择
自:Select 1.0.0
项目(行、列或单元格)已选择。
需要注意的是 - 此属性需要 Select 作为 DataTables 的扩展。
说明
此事件会在 DataTables 中选择项目(行、列或单元格)时触发,并提供已选择项目的相关信息。
需要注意的是,出于性能原因,每个选择操作只触发一个事件。结果是,如果在单次操作中选择多个项目(例如,在 os
选择样式中按 Shift 点击),则不会为每个选定的项目添加自己的事件,而是通过数组传达所选项目的相关信息。
此外,与所有 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('select', function (e, dt, type, indexes) {
if (type === 'row') {
var data = table
.rows(indexes)
.data()
.pluck('id');
// do something with the ID of the selected items
}
});
当一个项目被选中时添加自定义类
var table = new DataTable('#myTable');
table.on('select', function (e, dt, type, indexes) {
table[type](indexes)
.nodes()
.to$()
.addClass('custom-selected');
});