2024 年 7 月 19 日星期五
作者:Allan Jardine

DataTables 2.1

时间过得真快!感觉距 DataTables 2.0 发布大版本推出已经没过去多长时间,但实际上已经过去四个月了。在此期间,陆续发布了八个 2.0.x 补丁版本,修改一些内容并修复发现的错误。现在到了隆重推出 DataTables 2.1 的时候了,它在 2.0 的基础上新增了一些新功能并对其进行了改进。

这篇博客文章是详细描述 2.1 版本的一系列文档之一

这篇博客文章将概述该版本,具体详细信息请参阅其他文档。

下面我们考虑一下表格来了解 2.1 的部分新增功能

名称 链接

首先,您可能注意到,表格上方显示的三个功能元素在同一行中均匀分布。这只需简单使用 layout 选项,并将希望位于该行中的功能放在数组中

layout: {
    top: [
        'pageLength',
        'buttons',
        'search'
    ]
}

在 2.1 之前,默认 CSS 会在每行显示每个功能。现在,layout 全宽单元格中的功能将在行中均匀分布。StartEnd 单元格也受益于此更改,并允许在单行中显示多个功能。我们提供了更加 详细的示例

其次,如果您点击按钮,您将收到一个 alert,显示列的数据类型。您可能注意到,第一列具有一个新的数据类型:string-utf8,它会使 DataTables 使用 localeCompare 对数据进行排序,从而确保带有重音字符的排序正确。您还可以看到 FontAwesome 列并非 numeric 类型,而 2.0 会错误地将其识别为该类型。此修复是由于 DataTables 的数据类型检测能力大幅提高。

最后,对于此示例,如果您查看该表格的 HTML,您会看到该表格只是 <table id="blog-2-1" class="display">。在以前所有版本的 DataTables 中,您很可能必须添加 style="width:100%" 以确保该表格响应页面中的宽度变化。

点亮世界?

当然,小版本中的这些小更改不会点亮世界,但它们是些小便利,让使用 DataTables 更加容易。将所有这些小便利加在一起,它就成为了一款更加令人乐于使用的库!

还有其他新特性,例如对 Bulma 1.0(包括暗色模式)的完全支持,以及 ESM 环境的新 DataTable.use() 方法。请参阅 发行说明 了解所有新增内容、变更内容和修复内容的详细信息。

升级

升级到 2.1 只需更新 DataTables JS 和 CSS 文件即可

  • 如果你正在使用 npm / yarn,请对 datatables.net* 包运行升级
  • 如果你正在使用我们的 CDN,请 从下载生成器 获取最新源
  • 如果你托管下载的文件,还可以 从下载生成器 获取最新文件。

从 2.0 迁移到 2.1 时不太可能会遇到升级问题,但最好还是浏览一下 升级说明 以确保万无一失。可能影响视觉效果的最大变更是,如果你有自定义 CSS 影响了 layout 网格,那么将功能放在单行单元格中的更改将会生效。所有自定义 CSS 都可能需要更新或移除。

如果你还未尝试过 DataTables 2,请参阅 它的发布博客文章

和以往一样,我希望你享受使用 DataTables。欢迎在 论坛 中发表反馈意见。