每頁顯示筆數
用於控制 DataTables 每頁顯示筆數的按鈕集合。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充套件。
說明
通常，DataTables 的表格周圍會有四個控制和資訊元素，分別位於四個角落。 DataTables 預設在左上方顯示每頁顯示筆數的控制項，而 Buttons 通常也插入於此處，導致每頁顯示筆數列表為了將控制元素限制在四個而縮減。
當然，可以透過簡單地將 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']
}
}
});