虽然大多数时候您与DataTables的Javascript交互将使用本网站的“ 使用”部分中所述的初始化对象来完成,但有时您可能会发现对表进行一些外部控制很有用。jQuery.dataTable对象提供以下函数。
还有许多可用的插件API函数,它们扩展了DataTables的功能,超出了本页所述的内置函数。
注意那些使用服务器端处理的人:许多API函数假设数据存储在客户端而不是服务器端完成。因为诸如fnAddData和fnDeleteRow之类的函数不会影响数据库中保存的数据。事实上,DataTables不知道您是否使用数据库!因此,您必须对服务器进行必要的调用以根据需要操作数据,然后只需重绘表(fnDraw)以查看新数据。
$ 显示详细信息 |
对表的TR元素(来自tbody)执行jQuery选择器操作,并返回生成的jQuery对象。 |
_ 显示详细信息 |
几乎与$ in操作相同,但在这种情况下返回匹配行的数据 - 因此,使用的jQuery选择器应匹配TR行节点或TD / TH单元节点而不是任何后代,因此可以获取数据行/单元格。如果找到匹配的行,则返回的数据是用于创建行的原始数据数组/对象(如果来自DOM源,则生成的数组)。 此方法通常与$结合使用,其中两个函数都被赋予相同的参数,并且数组索引将相同地匹配。 |
fnAddData 显示详细信息 |
向表中添加一个新行或多行数据。请注意,这仅适用于客户端处理 - 如果您使用服务器端处理(即“bServerSide”:true),然后要添加数据,您必须将其添加到数据源,即服务器端,通过Ajax调用。 |
fnAdjustColumnSizing 显示详细信息 |
此函数将使DataTables根据表中包含的数据和应用于列的大小(在DOM,CSS或通过sWidth参数)重新计算列大小。当表的父元素的宽度发生变化时(例如窗口调整大小),这可能很有用。 |
fnClearTable 显示详细信息 |
快速简单地清理桌子 |
fnClose 显示详细信息 |
与“打开”行完全相反,此函数将关闭当前“打开”的所有行。 |
fnDeleteRow 显示详细信息 |
删除表的行 |
fnDestroy 显示详细信息 |
通过删除所有DataTables增强功能,对表结构和事件侦听器的更改,将表还原到DOM中的原始状态。 |
fnDraw 显示详细信息 |
重绘表格 |
fnFilter 显示详细信息 |
根据数据过滤输入 |
fnGetData 显示详细信息 |
根据提供的参数获取整个表,单个行或单个单元格的数据。 |
fnGetNodes 显示详细信息 |
获取表格主体中使用的TR节点数组。请注意,您通常希望优先使用'$'API方法,因为它更灵活。 |
fnGetPosition 显示详细信息 |
从包含隐藏列的DOM元素和列索引中获取特定单元格的数组索引 |
fnIsOpen 显示详细信息 |
检查行是否“打开”。 |
fnOpen 显示详细信息 |
此函数将在页面上当前显示的行之后直接放置一个新行,并将HTML内容传递给该函数。例如,这可用于要求确认应删除特定记录。 |
fnPageChange 显示详细信息 |
更改分页 - 在简单的API函数中提供分页的内部逻辑。使用此功能,您可以将DataTables表转到下一页,上一页,第一页或最后一页。 |
fnSetColumnVis 显示详细信息 |
显示特定列 |
fnSettings 显示详细信息 |
获取特定表的设置以进行外部操作 |
fnSort 显示详细信息 |
按特定列对表进行排序 |
fnSortListener 显示详细信息 |
将排序侦听器附加到给定列的元素 |
fnUpdate 显示详细信息 |
更新表格单元格或行 - 此方法将接受用于更新单元格的单个值,用于每列的一个元素的值数组或与原始数据源格式相同的对象。该功能是自引用的,以便更轻松地进行多列更新。 |
fnVersionCheck 显示详细信息 |
为插件提供一种通用方法来检查正在使用的DataTable的版本,以确保兼容性。 |
静态方法
除了适用于各个表的上述函数之外,DataTable还提供了许多静态函数,这些函数提供了有关在页面上使用DataTable的一般信息。可以通过对象$ .fn.dataTable。{functionName}访问这些函数。
fnVersionCheck 显示详细信息 |
为插件提供一种通用方法来检查正在使用的DataTable的版本,以确保兼容性。 |
fnIsDataTable 显示详细信息 |
检查TABLE节点是否已经是DataTable表。 |
fnTables 显示详细信息 |
获取已初始化的所有DataTable表 - 您可以选择仅获取当前可见的表。 |