行 ID
自:DataTables 1.10.8
DataTables 使用此数据属性名称设置 tr
元素 DOM ID。
说明
每个 tr
元素在 DataTable 中都有 id
属性 通常非常有用,方便进行行选择和数据源识别,尤其是在使用事件时。
DataTables 会尝试使用此选项定义的属性从每行的数据源自动读取 ID 值。默认情况下为 DT_RowId
,但可以设置为任何其他名称。与 columns.data
一样,它还能够使用 Javascript 点对象符号(例如 DT_RowId: 'image.id'
)从嵌套的 JSON 数据源读取数据。
如果找不到该行的 ID 值,则将不会自动设置 id
属性。
数据源中提供的任何行 ID 值都应符合 HTML 规范 关于可以采用的值的规定
此值在该元素的家庭子树中的所有 ID 中必须唯一,并且必须包含至少一个字符。该值不能包含任何空格字符。
您可能还需要考虑 CSS 2.1 对标识符的规范,该规范比 HTML5 更具限制性,且将与 jQuery 提供最大的兼容性
标识符(包括选择器中的元素名称、类别和 ID)只能包含字符 [a-zA-Z0-9] 和 ISO 10646 字符 U+00A0 及以上,以及连字符 (-) 和下划线 (_),它们不能以数字开头,不能包含两个连字符或连字符后面跟数字。标识符还可以包含转义字符和任何 ISO 10646 字符作为数字代码。
类型
此选项可采用以下类型:
默认值
- 值:
DT_RowId
示例
将属性 staffId
用作行 ID 的数据源
$('#myTable').DataTable({
ajax: '/api/staff',
rowId: 'staffId'
});
相关
以下选项直接相关,在您的应用程序开发中也可能有用。