page.len()

始於：DataTables 1.10

取得 / 設定表格的分頁長度。

描述

這個方法相當簡單地用於取得和設定 DataTables 用於顯示的分頁長度。請注意，這僅在表格中啟用paging時才相關。

特殊數字 -1 可以作為設定參數使用，然後由該方法的 get 格式返回，以表示將顯示 DataTable 中的所有列。

請注意，此方法設定要顯示的頁面，但實際上不會重新顯示表格。為了顯示新設定的頁面，請使用 draw() 方法，它可以簡單地作為 len() 方法的返回物件的鏈式方法呼叫，例如 table.page.len( 25 ).draw();。

類型

function page.len()

描述: 取得表格的分頁長度。請注意，如果 API 的上下文中有多個表格，則將使用上下文中第一個表格的分頁長度。如果您在單個 API 上下文中處理多個表格，請使用 table()。
返回: 整數

目前分頁長度。請注意，如果傳遞了 -1 作為設定參數，表示要顯示所有記錄，則此方法也將返回 -1。

function page.len( set )

描述

設定顯示時要使用的分頁長度

參數

返回

	名稱	類型	可選
1	`set`	`整數`	否
	要設定的分頁長度。使用 `-1` 顯示所有記錄，有效地停用分頁。

DataTables.Api

DataTables API 實例

範例

允許使用者點擊兩個元素來選擇是否顯示所有記錄或僅顯示 10 個

var table = new DataTable('#myTable');

$('#all').on('click', function () {
	table.page.len(-1).draw();
});

$('#_10').on('click', function () {
	table.page.len(10).draw();
});