{hero}

columns.title

自:数据表 1.10

设置列标题。

描述

列的标题显示在该列的表头单元格中。在扩展程序中,也可用于其他交互,如列可见性控制、筛选等。

列的标题通常直接从 DOM 中读取(从 thead 元素中的单元格),但覆盖现有值或让数据表实际为您构建包含列标题的标题(例如,如果在构建数据表之前表中没有 thead 元素)可能很有用。此选项可用于提供该功能。

自数据表 2 起,该软件将自动将列标题包装在类为 `dt-column-title` 的 span 元素中。这样做是为了确保可以读写列标题,而不会干扰列标题中可能存在的其他元素。

请注意,构建标题时,数据表只能为每列构建一个包含单个单元格的简单标题。带有 `colspan` 和 `rowspan` 属性的复杂标题必须已在文档中定义,或使用标准 DOM/jQuery 方法构建。此外,如果您对 DOM 中的多行标题使用此属性,则仅对标题的第一行设置标题。

类型

此选项可以采用以下类型给出

默认

从列的标题单元格读取的值。

示例

使用 columnDefs 设置第一列的标题

new DataTable('#myTable', {
	columnDefs: [
		{
			title: 'My column title',
			targets: 0
		}
	]
});

使用 columns 设置第一列的标题

new DataTable('#myTable', {
	columns: [{ title: 'My column title' }, null, null, null, null]
});

相关

以下选项直接相关,在应用程序开发中也可能很有用。