state() 获取最新保存的表的状态

最低支持版本:DataTables 1.10.1


描述(Description)

stateSaveOption 开启时,知道某个特定时刻表保存的状态是很有用的。该方法提供了获取最新保存的状态。

该数据格式如下所示,但请注意,作为DataTables的插件和扩展可以通过添加所需要的状态信息来修改这个结构。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
    "time":   {number}               // 该状态创建的时间戳(Time stamp of when the object was created)
    "start":  {number}               // 显示起始位置(Display start point)
    "length": {number}               // 分页长度(Page length)
    "order":  {array}                // 排序信息的二维数组(2D array of column ordering information (see `order` option))
    "search": {
        "search":          {string}  // 搜索词(Search term)
        "regex":           {boolean} // 表明搜索词是否当做正则表达式处理(Indicate if the search term should be treated as regex or not)
        "smart":           {boolean} // 标记是否开启内置搜索(Flag to enable DataTables smart search)
        "caseInsensitive": {boolean} // 是否区分大小写(Case insensitive flag)
    },
    "columns" [
        {
            "visible": {boolean}     // 列隐藏信息(Column visibility)
            "search":  {}            // 列搜索的信息(Object containing column search information. Same structure as `search` above)
        }
    ]
}

请注意,这个方法提供获取最新的状态,但不一定是当前的状态。比如 page()API 方法不会自动触发状态保存。调用 draw()API 方法或者 state.save()API 方法来保存状态。

类型(Type)

这个选项能够接受以下类型的参数:


function state()


描述(Description):

获取最新表的状态

返回(Returns):

objectType

被保存的状态对象


例子(Example)

从状态对象获取分页长度

1
alert( '保存的分页长度是: '+ table.state().length );

相关属性(Related)

下面的选项是直接相关的,也可能是您的应用程序的开发非常有用。

API

Events

Options

https://datatables.net/reference/api/state()

Translation from DataTables.net, with permission

百度站内搜索

Google站内搜索

赞助我们

赞助我们

您的支持,将是我们前进的最大动力……