{hero}

rowId

自:DataTables 1.10.8 起

DataTables 將用來設定 tr 元素 DOM ID 的資料屬性名稱。

描述

在 DataTable 中的每個 tr 元素上設定一個 id 屬性,對於列選取和資料來源識別通常很有用,尤其是在使用事件時。

DataTables 會嘗試使用此選項定義的屬性,自動從每一列的資料來源讀取 ID 值。預設值為 DT_RowId,但可以設定為任何其他名稱。與 columns.data 一樣,它也可以使用 Javascript 點號物件表示法 (例如 DT_RowId: 'image.id') 從巢狀 JSON 資料來源讀取。

如果找不到列的 ID 值,則不會自動設定 id 屬性。

資料來源中給定的任何列 ID 值都應符合 HTML 規範對其可接受值的定義。

該值在元素的 home 子樹中的所有 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'
});

相關

以下選項與此選項直接相關,可能在您的應用程式開發中也很有用。