描述(Description)
此方法提供了将排序监听附加到页面上任何一个DOM元素的功能。这与DataTables在内部用于为每个列附加到thead
的排序监听器使用的方法相同。(比如,点击排序,按住shift多列排序)
虽然不是常用方法,但是可以从外部触发表排序操作(equally
order()API
and its columns counterparts could also be used)
注意,与
order()API
和
columns().order()API
不同,当通过此功能附加的监听器被激活时,
它将导致表格自动重绘,也就是它不需要额外调用
draw()API
方法来重绘表格。
类型(Type)
这个选项能够接受以下类型的参数:
function order.listener( node, column, callback )
描述(Description):
将排序监听附加到指定的元素
参数(Parameters):
名称(Name) | 类型(Type) | 是否可选(Optional) | |
---|---|---|---|
1 | node |
nodeType
,
jQueryType
,
stringType
|
No |
需要附加监听器的选择器/节点。这可以是DOM节点,jQuery集合节点或jQuery选择器字符串。 | |||
2 | column |
integerType
|
No |
监听器被触发,导致该列的数据进行排序。 | |||
3 | callback |
functionType
|
No |
当监听器执行排序操作完成时的回调函数。没有参数传入,也不会返回。 |
返回(Returns):
包含当前排序的结果集的DataTables API实例
例子(Example)
当 #sorter
元素被点击时,排序第一列
1
2
3
var table = $('#example').DataTable();
table.order.listener( '#sorter', 1 );
相关属性(Related)
下面的选项是直接相关的,也可能是您的应用程序的开发非常有用。
API
Options