pageLength
控制 DataTables 分页长度的按钮集合。
请注意 - 该属性需要 DataTables 的 按钮 扩展。
描述
在 DataTable 周围有四个表控件和信息元素很常见 - 每个角落都有一个。DataTables 的默认显示形式是左上角的分页长度控件，通常插入按钮，导致分页长度列表被删减，以将控件元素限制为四个。
当然，可以通过简单地将 l 选项添加到 dom 配置中，将默认的分页长度列表插入回文档，但它可能看起来很混乱。
因此，Buttons 提供了 pageLength 按钮类型，作为其核心软件的一部分，作为 DataTables 默认长度列表的直接替换。这样允许保留分页长度控件，同时享受与 Buttons 的完全样式集成。
该按钮将读取 DataTables lengthMenu 配置选项使用的配置，因此相同的配置可用于该按钮以及 DataTables 的默认分页长度控件。
选项
除了可用于所有按钮的选项（例如 buttons.buttons.text），该按钮可以在其配置对象中设置以下选项以自定义其动作和显示
| 名称 | 类型 | 默认 |
|---|---|---|
action | ||
显示集合以允许选择分页长度。 | ||
className | buttons-collection buttons-page-length | |
按钮的类名。有关详细信息，请参阅 | ||
text | {'-1': '显示所有行', _: '显示 %d 行'} | |
按钮的显示文本。默认情况下，这是一个使用显示的对象的函数，其中 | ||
示例
DataTables 初始化：使用默认选项显示 pageLength 按钮
new DataTable('#myTable', {
layout: {
topStart: {
buttons: ['pageLength']
}
}
});指定 lengthMenu 的分页长度按钮
new DataTable('#myTable', {
layout: {
topStart: {
lengthMenu: [
[10, 25, 50, -1],
['10 rows', '25 rows', '50 rows', 'Show all']
]
}
},
buttons: ['pageLength']
});集合按钮的自定义语言字符串（注意使用对象允许将 -1 值（即显示全部）指定为语言字符串）
new DataTable('#myTable', {
language: {
buttons: {
pageLength: {
_: 'Afficher %d éléments',
'-1': 'Tout afficher'
}
}
},
layout: {
topStart: {
buttons: ['pageLength']
}
}
});