DataTable.tables()
自 DataTables 1.11 起
获取页面上的所有 DataTables。
描述
能够获取页面上现有 DataTables 的列表可能很有用,尤其是在表格启用了滚动并且需要在可见时调整其列宽的情况下。此方法提供了这种能力。
请注意,这是一个**静态**函数,可以通过DataTable
或$.fn.dataTable
对象访问,而不是API实例。它可以在任何时间访问,即使在页面上创建任何 DataTables 之前。
在 DataTables 1.11 之前,此方法只能通过$.fn.dataTable
对象访问。从 1.11 开始,可以使用DataTable
或$.fn.dataTable
。
类型
function tables( [ visible ] )
- 描述
获取所有已初始化的 DataTable 表格 - 可选地,您可以选择仅获取当前可见的表格和/或将表格作为 API 实例检索。
- 参数
名称 类型 可选 1 visible
是 - 默认值:false 作为布尔值,此选项用于指示您是否希望返回页面上的所有表格(
false
),或仅返回可见表格(true
)。自 1.10.8 起,此选项也可以作为对象提供,该对象具有以下可选参数
布尔值
visible
- 获取仅可见的表格(true
)或所有表格,无论可见性如何(false
)。布尔值
api
- 为选定的表格返回一个DataTables.Api
实例或一个数组
- 返回值
包含所有匹配 DataTables 的 DataTable API 实例
示例
非 jQuery:调整所有可见表格的列宽
DataTable.tables({ visible: true, api: true }).columns.adjust();
调整所有可见表格的列宽
$.fn.dataTable.tables({ visible: true, api: true }).columns.adjust();
在 Bootstrap 选项卡中显示表格时调整列宽
$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
$.fn.dataTable.tables({ visible: true, api: true }).columns.adjust();
});