language.lengthMenu

自 DataTables 1.10 起

頁面長度選項字串。

描述

詳細說明當分頁長度選項的下拉式選單變更時將採取的動作。符號 _MENU_ 會被預設的 10、25、50 和 100 的選項清單取代（或由 lengthMenu 指定的任何其他值），並且如果需要，可以用自訂的選項清單取代。此選項是 pageLength.text 的每個表格設定，可用於覆蓋此選項（例如，如果表格有兩個或多個頁面長度控制項）。

從 DataTables 2 開始，生成的 DOM 結構可能會根據字串中 _MENU_ 符號的位置而改變。如果符號位於字串的開頭或結尾，生成的 DOM 會將 select 放在 label 的外部。這樣做是為了讓 select 和 label 之間建立明確的連結，以提升可訪問性（詳情請參閱這篇文章）。

如果符號位於字串的中間，則創建的 DOM 結構會將 select 嵌套在 label 中，建立一個隱含的連結（儘管 for 和 id 屬性仍然被設置）。某些螢幕閱讀器可能難以處理這種形式，因此不建議使用。

只有當您對頁面應用自訂樣式時，這種 DOM 結構的區別才具有意義。您可能需要根據使用的字串更改您的 CSS。

此外，此屬性可以利用 language.entries 來輕鬆更新字串，使其與表格中顯示的特定資料類型相關。它的複數形式會自動與選項清單中選擇的數字進行解析。您希望顯示已解析的 language.entries 值的地方，應該使用 _ENTRIES_ 替換符號。

類型

此選項可以設定為以下類型：

字串

預設值

值：_MENU_ _ENTRIES_ 每頁

範例

僅語言變更

new DataTable('#myTable', {
	language: {
		lengthMenu: 'Display _MENU_ records'
	}
});

使用條目變更語言

new DataTable('#myTable', {
	language: {
		lengthMenu: 'Display _MENU_ _ENTRIES_',
		entries: {
			_: 'people',
			1: 'person'
		}
	}
});

語言和選項變更（但最好使用 lengthMenu！）

new DataTable('#myTable', {
	language: {
		lengthMenu:
			'Display <select>' +
			'<option value="10">10</option>' +
			'<option value="20">20</option>' +
			'<option value="30">30</option>' +
			'<option value="40">40</option>' +
			'<option value="50">50</option>' +
			'<option value="-1">All</option>' +
			'</select> records'
	}
});