6.警告:可能列不对齐

在 DataTables 中通过使用 scrollXscrollY 参数启用滚动时,它会将表格拆分为两个或三个独立的 HTML table 元素;页眉、主体,以及可选的页脚。这是为了能够以跨浏览器方式滚动 DataTable 的不同部分。

警告

警告:可能列不对齐

将在 DataTables 无法在不同的表格之间正确对齐列时出现。由于页眉、主体和页脚列可能无法正确对齐,因此这种效果可能会让最终用户感到有些不安,因此如果您的网站上出现此错误,解决此错误非常重要。

含义

当 DataTables 在启用滚动的情况下执行绘制时,它会对表格中的列应用一致的宽度,以便跨表格中的两个或三个滚动组件对齐列。完成此操作后,DataTables 将执行健全性检查以查看列是否已对齐(请注意,此健全性检查并非万无一失!未显示此错误也可能发生列对齐不正确的情况 - 完整的检查会阻碍表格的性能)。如果健全性检查失败,则会显示警告。

基本上,这意味着列在视觉上错位的可能性很高。

诊断

从根本上讲,这可能是由于表格绘制在一个空间中,该空间对于表格中的内容而言太小。例如,内容总宽度为 500px 的表格,不能绘制在小于此空间中。页眉可能可以,但是正文内容不行,所以就会出现错位。

通过使用浏览器开发工具(特别是“检查元素”选项查看实时 DOM),我们可以检查页面 HTML 元素,找出限制了表格宽度的是哪个。

解决方案

导致此警告的原因可能是 HTML 页面中多项不同配置和 DataTables 初始化。它们包括

  • 如果你正在使用垂直滚动(scrollY),而不是水平滚动(scrollX),请启用水平滚动选项,这样表格才有空间可以滚动。
  • 如果你正在使用选项 scrollXInnersScrollXInner - 请将其移除。这些选项会将内部表格强制设置为特定宽度,这一宽度可能不适合表格内容。从 DataTables 1.10 开始,这些选项不再记录在案,因为它们造成的危害多于帮助,但为了向后兼容而保留。如果你希望表格中每行的内容都在一行中,通常会使用这些参数,请使用以下 CSS
table.dataTable tbody th,
table.dataTable tbody td {
    white-space: nowrap;
}