功能

放置在 DataTable 周圍的表格控制項和資訊元素稱為「功能」,每個功能都有自己的組態選項。功能的放置位置由 layout 選項定義,其中每個插槽都可以包含功能描述符。

DataTables 有四個內建功能

可以使用 DataTable.feature.register() 方法新增新功能,DataTables 的官方擴充功能廣泛使用此方法。

以下選項顯示如何使用 layout 選項來停用表格左上角的預設 pageLength,並將分頁控制項放置在右上角。

new DataTable('#myTable', {
    layout: {
        topStart: null
        topEnd: 'paging'
    }
} );
函式庫 名稱 摘要
內建 - 資訊

info

表格資訊顯示

內建 - 資訊

info.callback

資訊顯示回呼

內建 - 資訊

info.empty

空表格文字

內建 - 資訊

info.postfix

資訊字串後綴

內建 - 資訊

info.search

當搜尋啟用時,附加到資訊字串

內建 - 資訊

info.text

表格摘要資訊顯示字串

內建 - 頁面長度

pageLength

分頁長度控制

內建 - 頁面長度

pageLength.menu

頁面長度控制的文字

內建 - 頁面長度

pageLength.text

頁面長度控制的文字

內建 - 分頁

paging

分頁按鈕

內建 - 分頁

paging.boundaryNumbers

是否在數字中包含開頭的第一頁和最後一頁。

內建 - 分頁

paging.buttons

設定分頁數字按鈕的最大數量

內建 - 分頁

paging.firstLast

是否在分頁控制項中包含第一個和最後一個按鈕。

內建 - 分頁

paging.numbers

是否在分頁控制項中包含數字。

內建 - 分頁

paging.previousNext

是否在分頁控制項中包含上一個和下一個按鈕。

內建 - 分頁

paging.type

分頁按鈕顯示選項

內建 - 搜尋

search

全域搜尋輸入

內建 - 搜尋

search.placeholder

輸入元素的預留位置

內建 - 搜尋

search.processing

搜尋時顯示處理指示器

內建 - 搜尋

search.text

搜尋控制項的文字

內建 - Div

div

文字/ HTML 容器

內建 - Div

div.className

設定所建立元素的類別名稱。

內建 - Div

div.html

設定元素的 HTML 內容。

內建 - Div

div.id

設定所建立元素的 ID。

內建 - Div

div.text

設定元素的文字內容。

按鈕

buttons

表格控制項按鈕

按鈕

buttons.buttons

要建立的按鈕清單

按鈕

buttons.buttons.action

按鈕啟用時要執行的動作

按鈕

buttons.buttons.async

指示應非同步執行按鈕的動作處理。

按鈕

buttons.buttons.attr

要為按鈕設定的屬性鍵/值集合

按鈕

buttons.buttons.available

確保在初始化按鈕之前已滿足任何需求

按鈕

buttons.buttons.className

設定按鈕的類別名稱

按鈕

buttons.buttons.destroy

銷毀按鈕時呼叫的函式

按鈕

buttons.buttons.enabled

設定按鈕的初始啟用狀態

按鈕

buttons.buttons.extend

定義按鈕應基於哪個按鈕類型

按鈕

buttons.buttons.init

可以用於新增此按鈕特定事件的初始化函式

按鈕

buttons.buttons.key

為按鈕定義啟用鍵

按鈕

buttons.buttons.name

為每個選取項目設定名稱

按鈕

buttons.buttons.namespace

每個按鈕的唯一命名空間

按鈕

buttons.buttons.split

分割下拉式按鈕

按鈕

buttons.buttons.tag

設定按鈕的標籤

按鈕

buttons.buttons.text

要在按鈕中顯示的文字

按鈕

buttons.buttons.titleAttr

按鈕 title 屬性文字

按鈕

buttons.name

為群組選取器的執行個體設定名稱

SearchBuilder

searchBuilder

啟用並設定 DataTables 的 SearchBuilder 擴充功能

SearchBuilder

searchBuilder.columns

限制可以篩選哪些欄

SearchBuilder

searchBuilder.conditions

為 SearchBuilder 定義自訂條件

SearchBuilder

searchBuilder.depthLimit

對群組的深度施加限制

SearchBuilder

searchBuilder.enterSearch

在按下 Enter 鍵時觸發搜尋,而不是每次按鍵

SearchBuilder

searchBuilder.filterChanged

在進行選取時更新標題文字的函式。

SearchBuilder

searchBuilder.greyscale

從 SearchBuilder 中移除色彩

SearchBuilder

searchBuilder.liveSearch

控制即時搜尋作業

SearchBuilder

searchBuilder.logic

設定預設邏輯運算子

SearchBuilder

searchBuilder.preDefined

設定預先定義的搜尋查詢

SearchPanes

searchPanes

啟用 Search Panes

SearchPanes

searchPanes.cascadePanes

允許窗格在選取下層疊

SearchPanes

searchPanes.clear

停用按鈕以允許快速清除窗格中的選取項目

SearchPanes

searchPanes.collapse

允許 SearchPanes 折疊

SearchPanes

searchPanes.columns

選取顯示窗格時應考量的欄

SearchPanes

searchPanes.controls

隱藏控制項按鈕並停用所有窗格中的搜尋

SearchPanes

searchPanes.dtOpts

定義用作窗格的 DataTables 屬性

SearchPanes

searchPanes.emptyMessage

已過時。設定自訂空訊息

SearchPanes

searchPanes.filterChanged

在進行選取時更新標題文字的函式。

SearchPanes

searchPanes.hideCount

隱藏所有窗格中的計數欄

SearchPanes

searchPanes.i18n

語言選項的容器

SearchPanes

searchPanes.i18n.clearMessage

設定要在「清除」按鈕中顯示的訊息

SearchPanes

searchPanes.i18n.collapse

設定要在 SearchPanes 按鈕中顯示的訊息

SearchPanes

searchPanes.i18n.collapseMessage

設定要在「折疊」按鈕中顯示的訊息

SearchPanes

searchPanes.i18n.count

設定在未搜尋時要在計數欄中顯示的訊息

SearchPanes

searchPanes.i18n.countFiltered

設定在搜尋時要在計數欄中顯示的訊息

SearchPanes

searchPanes.i18n.emptyMessage

將國際化新增至顯示為窗格選項的空訊息

SearchPanes

searchPanes.i18n.emptyPanes

將國際化新增至未顯示任何窗格時顯示的訊息

SearchPanes

searchPanes.i18n.loadMessage

將國際化新增至載入窗格時顯示的訊息

SearchPanes

searchPanes.i18n.showMessage

設定要在「顯示」按鈕中顯示的訊息

SearchPanes

searchPanes.i18n.title

將國際化新增至顯示已選取多少個窗格的標題

SearchPanes

searchPanes.initCollapsed

在初始化時折疊 SearchPanes

SearchPanes

searchPanes.layout

設定如何在頁面上顯示窗格的版面配置

SearchPanes

searchPanes.order

設定窗格的順序

SearchPanes

searchPanes.orderable

隱藏所有窗格中的排序按鈕

SearchPanes

searchPanes.panes

定義跨所有欄篩選的自訂窗格

SearchPanes

searchPanes.panes.className

為自訂窗格新增自訂類別

SearchPanes

searchPanes.panes.dtOpts

定義自訂窗格的 DataTables 選項

SearchPanes

searchPanes.panes.header

定義自訂窗格的標頭

SearchPanes

searchPanes.panes.options

定義自訂窗格的選項

SearchPanes

searchPanes.panes.options.className

將類別新增至自訂窗格的特定選項

SearchPanes

searchPanes.panes.options.label

定義自訂窗格選項的標籤

SearchPanes

searchPanes.panes.options.value

定義自訂窗格選項的值

SearchPanes

searchPanes.panes.preSelect

已過時。定義自訂窗格的任何預先選取項目

SearchPanes

searchPanes.preSelect

窗格中的預先選取選項

SearchPanes

searchPanes.threshold

設定欄中顯示其窗格所需的唯一值與總值的最小比率

SearchPanes

searchPanes.viewCount

在所有窗格中顯示計數欄

SearchPanes

searchPanes.viewTotal

在搜尋時更新計數欄以顯示可見計數