sort()
自 DataTables 1.10 起
对 API 实例结果集的元素进行排序。
描述
sort()
方法提供了一种对 API 实例结果集中的数据进行排序的方法,如果你想将这些数据显示给最终用户,这种方法会特别有用,例如作为 select
列表用于搜索输入。此方法不应与 order()
混淆,order()
用于对 DataTable 中的记录进行排序。
此方法利用了 DataTables API 对象“类似于数组”的事实,它们继承了 Javascript Array
类型的大量功能和方法。
在这种情况下,此方法是 Javascript Array.prototype.sort
方法的代理,并作为 DataTables API 的实用程序方法提供。有关原始方法的更多信息,请参考 sort
的 Mozilla MDN 文档。
类型
函数 sort( [ fn ] )
- 描述
对 API 实例结果集的元素进行排序。
- 参数
名称 类型 是否必需 1 fn
是 - 默认值 这是标准 Javascript 排序比较函数。它接受两个参数
- 要比较的值 1
- 要比较的值 2
并期望返回一个指示这两个值排序位置的值。小于 0 表明第一个值在第二个值之前,大于 0 表明第一个值在第二个值之后,返回 0 表明这两个值相同。
- 返回值
原始 API 实例,其结果集已按照使用的排序条件进行排序。
示例
从列中对数据进行排序
var table = new DataTable('#myTable');
var data = table
.column(0)
.data()
.sort();