columns().titles()
自:DataTables 2.0
取得 / 設定多個欄位的標題。
說明
此方法用於取得和設定多個欄位的標題(也可以在初始化時透過 columns.title
設定)。欄位的標題會顯示在表格的標頭中。它也可以用於額外功能,例如欄位可見性控制和匯出資料。
DataTables 將欄位標題包裝在具有 dt-column-title
類別的 span
元素中。這樣做是為了允許此方法進行取得/設定操作,同時仍然允許在標頭單元格中存在其他 HTML(例如,內嵌按鈕)。
類型
function columns().titles( [ row ] )
- 說明
此方法將取得所選欄位的標題
- 參數
名稱 類型 可選 1 row
是 此參數可用於控制從
thead
中的哪一行讀取標題。該參數將傳遞給column().header()
以確定要使用哪個標頭列。- 回傳
所選欄位的標題。
function columns().titles( title [, row ] )
- 說明
此方法將字串寫為多個欄位的標題。
- 參數
名稱 類型 可選 1 title
否 要寫入所選欄位的表格標頭的新標題。此字串將用於所有選定的欄位,因此,此重載用途有限。如果您希望每個欄位使用不同的字串,請使用
column().title()
並遍歷陣列或其他欄位標題來源。2 row
是 此參數可用於控制從
thead
中的哪一行讀取標題。該參數將傳遞給column().header()
以確定要使用哪個標頭列。- 回傳
用於鏈式呼叫的 DataTables API 實例。
範例
取得所有欄位的標題:
var table = new DataTable('#myTable');
var titles = table.columns().titles();
// Do something with titles...
相關
以下選項直接相關,也可能在您的應用程式開發中很有用。