{hero}

columns.ariaTitle

自 DataTables 1.10.25 版本起

设置列的 aria-label 属性值。

描述

此选项可用于为列标题使用的 aria-label 属性提供自定义字符串,以便为屏幕阅读器提供增强的辅助功能。默认情况下,DataTables 将使用现有的 aria-label 属性或列标题(columns.title,或从文档中读取),但此选项为此提供了自定义功能。

请注意,如果列可以由最终用户排序,则此处给定的值将附加 language.aria.sortAscendinglanguage.aria.sortDescending,以便向屏幕阅读器用户指示情况。

类型

此选项可以以下类型给出:

默认值

默认情况下使用 columns.title

示例

使用 columnDefs 设置第一列的 aria-label。

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

使用 columns 设置第一列的 aria-label。

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

相关

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