{hero}

init()

自:DataTables 1.10.6

取得表格所使用的初始化選項。

說明

此方法提供對用於建立 DataTable 的初始化物件的存取權。 其目的是供希望在其 DataTables 外掛程式的標準組態物件中提供自訂選項的外掛程式作者使用。

在使用此方法進行開發時,請記住 DataTables 選項都是可選的。 它們可能存在於此物件中,也可能不存在。 一般而言,您不應該檢查內建選項的值 (例如,paging),而是應該檢查自訂物件。

不應寫入傳回的物件。 任何變更都不會被 DataTables 偵測到,並可能導致無法預測的結果。 因此,傳回的物件應被視為唯讀。

此方法無法感知多表格 - 如果有多個表格,它將傳回用於環境定義中第一個表格的組態物件 - 如果您需要多表格環境定義中所有表格的組態物件,請使用 iterator() 方法。

最後,由於 DataTables 為了向後相容性的內部運作方式,此物件很可能會同時包含 camelCase 初始化選項和相同參數的匈牙利表示法版本。 強烈建議您對於自訂參數僅使用 camelCase 選項,因為這是 DataTables v1.10+ 的文件記載方式。

類型

function init()

說明

取得表格所使用的初始化選項。

傳回

組態物件

範例

監聽 init 事件,並根據初始化物件中給定的選項檢查是否應初始化某個功能。

$(document).on('init.dt', function (e, settings) {
	var api = new $.fn.dataTable.Api(settings);

	if (api.init().pageResize || $.fn.dataTable.defaults.pageResize) {
		new PageResize(api);
	}
});

相關

下列選項與此直接相關,在您的應用程式開發中也可能很有用。