{hero}

buttons().containers()

自:Buttons 1.0.0 起

取得一個或多個按鈕實例的容器元素。
請注意 - 此屬性需要 DataTables 的 Buttons 擴展。

描述

建立新按鈕組的 buttons 方法,可讓您一次只新增一組按鈕。然而,Buttons 可以將多組按鈕附加到單一 DataTable。這是透過 new $.fn.dataTable.Buttons() 介面建立額外的按鈕組來完成的。一旦建立,按鈕可以像平常一樣透過 DataTables API 存取。

此方法提供存取 buttons() 選擇器方法所選取的按鈕實例的容器元素。然後可以使用標準 jQuery 方法將這些元素插入到您希望的文檔中的任何位置。此方法也可用於將按鈕組從文檔中的一個位置移動到另一個位置 (例如,使用 buttons 方法,並將按鈕移動到 DataTables 控制的 DOM 之外)。

當使用 buttons() 選擇器方法時,在處理此方法時,第二個參數(按鈕選擇器)實際上會被忽略。只會使用按鈕實例。

類型

function buttons().containers()

描述

取得一個 jQuery 實例,其中包含對按鈕容器實例的參考。

回傳

包含所選按鈕實例容器元素的 jQuery 實例。

範例

將使用 new DataTable.Buttons() 建立的按鈕插入到文檔中

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

new DataTable.Buttons(table, {
	name: 'commands',
	buttons: [
		// ...
	]
});

table
	.buttons()
	.containers()
	.appendTo('body');