技术说明

以下是技术说明的集合,其中包含有关 DataTables 可报告错误的信息、对 Javascript 未直接报告的错误状态(比如 CSS 渲染问题)的额外信息,以及在使用 DataTables 时(通常是论坛讨论答案的扩展)常常感兴趣的常规主题。

如果你遇到一个你觉得需要详细解释的问题,请在 论坛 中发布请求,或 给我发送消息

技术说明

1. 警告:无效的 JSON 响应

一个来自 DataTables 的警告,指出 “无效的 JSON 响应”,这是使用 DataTables 时最常见的错误之一。此技术说明确切说明了其含义,以及如何诊断导致问题的原因。 阅读更多 »

2. 警告:非表格节点初始化

DataTables 仅在 HTML 表格 元素上初始化。在任何其他元素类型上运行 DataTables 会导致错误,此处有详细说明。 阅读更多 »

3. 警告:无法重新初始化 DataTable

DataTables 无法通过向 DataTables 构造函数传入其他选项来动态更改其功能。一旦创建了表格,就只能通过 API 来操作。传入新参数将导致错误。 阅读更多 »

4. 警告:请求未知参数

当 DataTables 尝试从数据源获取数据但无法获取数据时,它将触发此警告,告诉你数据不存在于预期的地方。 阅读更多 »

5. 警告:未知的分页操作

如果 page() 方法使用 DataTables 不知道的操作调用,将出现此警告。 阅读更多 »

6. 警告:可能存在列错位

当启用滚动时,DataTables 会将一个表格拆分成两个单独的 table 元素,然后尝试匹配这两个表格之间的列宽。当 DataTables 无法匹配这两个表格之间的列宽时,会产生此警告。 阅读更多 »

7. 警告:Ajax 错误

当 DataTables 在执行 Ajax 请求时遇到一般错误或未知错误时,将显示此警告消息。这需要深入了解有关 Ajax 请求的信息,了解其失败的原因,正如此技术说明中所述。 阅读更多 »

8. DataTables 标记

Markdown 是一个纯文本格式语法,最初由 John Gruber 创建,现已广泛用于网络。它旨在提供一套易于使用的格式化规则,这些规则可以应用于文档,将文档从易于阅读和编辑的纯文本格式转换为 HTML。DataTables 项目在多个领域使用 Markdown。 阅读更多 »

9. JS Bin

DataTables.net 提供了 JS Bin 的一个自定义安装程序,可在 http://live.datatables.net 获得,该程序经过定制以满足快速开发和测试 DataTables 代码的需求。借助 JS Bin,您可以轻松尝试一个选项或 API 方法,并在提交问题时提供测试用例。 阅读更多 »

10. 寻求帮助

如果您在使用 DataTables 或其任何扩展时遇到问题,您会想要寻求一些帮助。我们这里有一个出色的社区,这里有许多乐于提供帮助且知识渊博的人员,但是,以提供足够信息的方式提出问题以便回答问题非常重要。此技术说明提供了寻求帮助的指南。 阅读更多 »

11. 编辑器:无法从源自动确定字段。

当激活 Editor bubble()inline() 方法时,它将自动尝试确定作为第一个参数传递给该功能的元素与 field 中的哪个字段相关。如果它无法这样做,Editor 将发出以下错误:无法从来源自动确定字段。请指定字段名。此技术说明描述了导致此错误的原因以及如何解决此错误。 阅读更多 »

12. 编辑器:发生系统错误。

当执行 Editor 请求并且返回的数据不在预期格式(JSON)中时,Editor 将显示一条错误消息,指出发生了错误。此技术说明详细解释了如何解决导致显示此常规错误的根本问题。 阅读更多 »

13. JS/CSS 文件名结构

此技术说明用于规范 DataTables 项目使用的文件命名约定。这些详细信息较为枯燥,但如果您要使用自动化工具和 DataTables,则这些详细信息可能会很有用。 阅读更多 »

14. 编辑器:无法找到行标识符

Editor 要求 DataTables 中的每一行都具有一个可以唯一标识该行的值。当 Editor 将编辑和删除请求提交给服务器时,使用此信息,以便服务器知道应提交哪一行。如果无法找到该信息,将出现“无法找到行标识符”错误。 阅读更多 »

15. 编辑器:需要 DateTime 库

在使用datetime字段类型时,必须为 DataTables 加载 DateTime 库。DateTime 库将为最终用户提供日期/时间选择器 UI,以便轻松输入日期和时间。 阅读更多内容»

16. 编辑器:字段仍在处理

如果在整个表单的字段处于处理状态时尝试提交表单,则编辑器将不会提交自。这样做是为了允许处理完成并确保数据完整性。 阅读更多内容»

17. 没有 Moment.js 或 Luxon 的格式化日期

已将日期/时间与非 ISO8601 格式一起使用,而页面上既没有 Moment.js,也没有 Luxon。 阅读更多内容»

18. 列计数不正确

标题和正文之间的列数不匹配 阅读更多内容»

19. 未设置 DataTables 库(Vue)

在 Vue 中设置 DataTables 时未指定 DataTable 库 阅读更多内容»

20. 示例运行时选项

有关 DataTables 示例中运行时选项的信息。 阅读更多内容»

21. i18n 文件加载错误

加载远程语言文件时出错 阅读更多内容»

22. DataTables 项目文件名

有关如何在 DataTables 中分配和使用文件名详细信息。 阅读更多内容»

23. 未设置 DataTables 库(React)

在 React 中设置 DataTables 时未指定 DataTable 库 阅读更多内容»

24. DataTables.net 编辑器文件

此网站上使用的 DataTables 编辑器 Javascript 文件在任何其他网站上都不能运行。 阅读更多内容»