SearchBuilder
SearchBuilder 使用分组和条件功能,让用户可以对数据表自定义复杂搜索。这样,可以提供高级的搜索控制,这些控制比现在 SearchPanes 或核心 DataTables 功能提供的搜索控制要先进。可以为组设置逻辑类型,并应用多种条件。
SearchBuilder 允许用户通过向一个明确并易于遵循的图形界面添加组和条件来构建搜索查询。SearchBuilder 中已经内置多种条件,这些条件可适用于 DataTables 识别的所有数据类型。SearchBuilder 自动识别列类型,并展示该列可用的条件。这些条件当然可以根据你的需要完全自定义设置,你也可以根据需要扩展条件,以适应自定义类型。
下载
获取和使用 SearchBuilder 最便捷的方式是使用 DataTables 下载生成器,你可以在下载生成器中选择想要在你页面中使用的软件,下载生成器会为你生成并托管一个 JavaScript 文件和一个 CSS 文件。除了选择 SearchBuilder 包之外,你还要添加 DateTime 依存包。
或者,可以在你的页面中包含 独立文件,下载发行包 或者在 GitHub 中 克隆源代码仓库。
初始化
如果在你的页面中包括 SearchBuilder 扩展,那么 SearchBuilder 将自动适用于页面中的每张数据表。你可以通过 searchBuilder
特性和 DataTables layout
选项来自定义 SearchBuilder 的位置并对其进行配置。
// Simple initialisation:
new DataTable('#myTable', {
layout: {
topStart: 'searchBuilder'
}
});
// Or, with configuration options:
new DataTable('#myTable', {
layout: {
topStart: {
searchBuilder: {
// config options here
}
}
}
});
简单的初始化将自动启用你表格的 SearchBuilder。一些自定义选项包括:预定义的搜索、深度限制、列条件限制以及组的默认逻辑。有关可用选项的详细信息,请参阅 参考文档。
请注意,还可以通过顶层 searchBuilder
选项来配置 SearchBuilder。
旧的 dom
选项
如果你正在使用 DataTables 1.x 代码,可能会看到正在使用的 dom
参数,此参数使用 ASCII 字符串来定义放置表控制元素的位置。SearchBuilder 的字母是 Q
- 例如:
$('#myTable').DataTable({
dom: 'Qftip',
searchBuilder:{
// Your config here...
},
});
此设置将继续用于 DataTables 2(但不能同时作为 layout
- 它们是互斥的),但建议你更新为使用layout
。
功能
SearchBuilder 增加了以下特性
- 更强大的搜索功能
- 跨多列执行复杂的搜索
- 轻松更改逻辑运算符
- 自定义条件
- 完全可国际化
- 与 DataTables 支持的 Bootstrap、Foundation 及其他样式库完全集成