{hero}

buttons().containers()

自:Buttons 1.0.0 起

获取一个或多个按钮实例的容器元素。
请注意 - 此属性需要 DataTables 的 Buttons 扩展。

说明

用于创建一个新按钮集的 buttons 方法提供了一次只添加一组按钮的功能。但是,Buttons 有能力将多组按钮附加到一个 DataTable。这是通过 new $.fn.dataTable.Buttons() 接口来创建额外的按钮集来完成的。创建完成后,可以通过 DataTables API 照常访问按钮。

此方法提供访问 buttons() 选择器方法选择的按钮实例的容器元素的功能。然后,可以使用标准的 jQuery 方法将这些元素插入到您希望的文档中的任何位置。此方法还可以用于将按钮集从文档中的一个位置移动到另一个位置(例如,使用 buttons 方法并将按钮移到 DataTables 控制的 DOM 之外)。

使用 buttons() 选择器方法时,处理此方法时第二个参数(按钮选择器)实际上会被忽略。只使用按钮实例。

类型

函数 buttons().containers()

说明

获取包含对按钮容器实例的引用的 jQuery 实例。

返回值

包含所选按钮实例的容器元素的 jQuery 实例。

示例

将使用 new DataTable.Buttons() 创建的按钮插入到文档中

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

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

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