{hero}

dom

自:DataTables 1.10 起

定義表格控制元素在頁面上的顯示位置及其順序。

已棄用!

從 v2.0 開始,此功能已被棄用。此功能將在 3.0 版本中移除。

此選項已被 DataTables 2 中的 layout 選項取代,後者更加彈性、直觀且與樣式框架獨立。請勿在新專案中使用此選項,並積極更新較舊的專案以使用 layout 而不是此選項。

描述

DataTables 將在表格周圍添加一些元素,以控制表格並顯示有關表格的其他資訊。這些元素在螢幕上的位置由它們在文件物件模型 (DOM) 中的順序以及應用於元素的 CSS 組合控制。此參數用於控制它們在 DOM 中的排序和額外標記。

DataTables 中的每個表格控制元素都有一個與之關聯的單個字母,該字母用於此 dom 配置選項中,以指示該元素將出現在文件順序中的位置。

選項

DataTables 中的內建表格控制元素為

  • l - length 變更輸入控制
  • f - f過濾輸入
  • t - t表格本身!
  • i - 表格i資訊摘要
  • p - p分頁控制
  • r - r處理顯示元素

每個選項都可以多次指定(表格本身除外),可用於在表格的上方和下方都放置表格控制項。 DataTables 將自動同步這些多個控制項。

標記

除了這些選項外,您還可以指定要插入到文件中的其他 div 元素,這些元素可用於控制元素的樣式/巢狀。要新增標籤,預期的語法如下

  • <> - div 元素
  • <"class"> - 具有類別的 div
  • <"#id"> - 具有 ID 的 div
  • <"#id.class"> - 具有 ID 類別的 div

樣式

DataTables 支援的樣式函式庫將覆寫 dom 參數的預設值,並將其替換為適合其版面配置系統的值。例如,Bootstrap 整合利用了 Bootstrap 的網格版面配置。

外掛

可以開發 DataTables 功能外掛以向 DataTables 添加其他功能,並且通常會使用此選項,向 DataTables 核心功能添加新字母。例如,按鈕dom 添加 B 選項,以指定應將表格控制按鈕插入表格的位置。

以下擴充功能可以透過 dom 選項初始化

類型

此選項可以以以下類型給定

預設值

  • 值:null

預設值在 DataTables 1.x 中為 lfrtip。樣式整合將設定一個自訂值。從 DataTables 2 開始,由於此 layout 選項取代了此選項,其預設值為 null

範例

沒有過濾輸入控制

/* Results in:
    {length}
    {processing}
    {table}
    {information}
    {pagination}
*/
new DataTable('#myTable', {
	dom: 'lrtip'
});

// As of DataTables 2, use `layout`:

new DataTable('#myTable', {
  layout: {
    topEnd: null
  }
});

更簡單的包裝元素

/* Results in:
    <div class="wrapper">
      {filter}
      {length}
      {information}
      {pagination}
      {table}
    </div>
*/
new DataTable('#myTable', {
	dom: '<"wrapper"flipt>'
});

長度和篩選在上方,資訊和分頁在表格下方

/* Results in:
    <div>
      {length}
      {filter}
      <div>
        {table}
      </div>
      {information}
      {pagination}
    </div>
*/
new DataTable('#myTable', {
	dom: '<lf<t>ip>'
});

表格摘要在標頭中,過濾、長度和處理在頁腳中,並帶有清除元素。

/* Results in:
    <div class="top">
      {information}
    </div>
    {processing}
    {table}
    <div class="bottom">
      {filter}
      {length}
      {pagination}
    </div>
    <div class="clear"></div>
*/
new DataTable('#myTable', {
	dom: '<"top"i>rt<"bottom"flp><"clear">'
});

相關

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