pageLength

起始版本号: Buttons 1.0.0

用来控制表格每页显示条数的按钮

注意：这个需要使用Bottons扩展

说明(Description)

这个按钮比较常见，处于表格的左上角，用来控制表格显示数据的条数。 It is quite common to have four table control and information elements around a DataTable - one in each corner. DataTables' default display as a page length control in the top left, which where Buttons are often inserted, resulting in the page length list being dropped to keep the control elements limited to four.

默认显示在左上角，你可以通过 pageLengthButton 来配置位置

这个按钮将读取 lengthChangeOption 的配置，所以可以使用相同的配置，以及默认的页面条数

选项(Options)

这个按钮有以下选项配置:

名称	默认
`text`	{'-1': 'Show all rows', _: 'Show %d rows'}
按钮上显示的文字， By default this is a function that uses the object shown, where the `%d`value is replaced by the result from `page.len()API` (i.e. the current page length). 使用 `buttons.buttons.textOption` 配置显示的文字内容或者 `buttons.pageLength`,关于语言的配置参考 `languageOption`
`className`	buttons-collection buttons-page-length
按钮的class名称，详情参见 `buttons.buttons.classNameOption`
`action`
允许用户改变页面的长度

示例

Datatables初始化：使用默认配置显示 pageLength按钮

$('#myTable').DataTable( {
    dom: 'Bfrtip',
    buttons: [ 'pageLength' ]
} );

页面长度按钮用 lengthChangeOption 指定

$('#myTable').DataTable( {
    dom: 'Bfrtip',
    lengthMenu: [
        [ 10, 25, 50, -1 ],
        [ '10 rows', '25 rows', '50 rows', 'Show all' ]
    ],
    buttons: [
        'pageLength'
    ]
} );

国际化按钮（注意这里的 -1特殊字符代表显示所有数据）

$('#myTable').DataTable( {
    dom: 'Bfrtip',
    language: {
        buttons: {
            pageLength: {
                _: "显示 %d 项",
                -1: "显示所有"
            }
        }
    },
    buttons: [
        'pageLength'
    ]
} );

http://datatables.net/reference/button/pageLength
Translation from DataTables.net, with permission