dom
定義表格控制元素在頁面上的顯示位置及其順序。
已棄用!
從 v2.0 開始,此功能已被棄用。此功能將在 3.0 版本中移除。
此選項已被 DataTables 2 中的 layout
選項取代,後者更加彈性、直觀且與樣式框架獨立。請勿在新專案中使用此選項,並積極更新較舊的專案以使用 layout
而不是此選項。
描述
DataTables 將在表格周圍添加一些元素,以控制表格並顯示有關表格的其他資訊。這些元素在螢幕上的位置由它們在文件物件模型 (DOM) 中的順序以及應用於元素的 CSS 組合控制。此參數用於控制它們在 DOM 中的排序和額外標記。
DataTables 中的每個表格控制元素都有一個與之關聯的單個字母,該字母用於此 dom
配置選項中,以指示該元素將出現在文件順序中的位置。
選項
DataTables 中的內建表格控制元素為
l
-l
ength 變更輸入控制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
選項,以指定應將表格控制按鈕插入表格的位置。
類型
此選項可以以以下類型給定
預設值
- 值:
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">'
});
相關
以下選項直接相關,也可能在您的應用程式開發中很有用。