搜尋窗格

搜尋窗格會在 DataTable 中新增窗格,並具備透過選取窗格中的列來搜尋 DataTable 的能力。這對於新增更容易存取的搜尋功能和自訂搜尋功能非常有用。

搜尋窗格可以搜尋在多個窗格中選取的多個值。它們也提供定義自訂搜尋函式的功能,而這是透過簡單搜尋框無法實現的。

下載

取得和使用搜尋窗格最簡單的方式是使用DataTables 下載產生器,您可以在其中選取您希望在頁面上使用的軟體,並為您建立和託管單個 JavaScript 和 CSS 檔案。除了選擇搜尋窗格套件,您還必須新增相依的Select套件。

或者,也可以在您的頁面上包含個別檔案下載發行套件在 GitHub 上複製原始碼控制儲存庫

初始化

如果您在頁面上包含搜尋窗格擴充功能,它會自動適用於該頁面上的每個 DataTable。您可以透過searchPanes功能和 DataTables layout選項自訂搜尋窗格的位置並進行設定。

// Simple initialisation:
new DataTable('#myTable', {
    layout: {
        topStart: 'searchPanes'
    }
});

// Or, with configuration options:
new DataTable('#myTable', {
    layout: {
        topStart: {
            searchPanes: {
                // config options here
            }
        }
    }
});

簡單的初始化將自動在您的表格上啟用搜尋窗格。一些自訂選項包括,階層式窗格、檢視小計和自訂搜尋函式。請參閱參考文件,以取得可用選項的完整詳細資訊。

請注意,也可以透過頂層searchPanes選項設定搜尋窗格。

舊版 dom 選項

如果您正在使用 DataTables 1.x 程式碼,您可能會看到正在使用dom參數,該參數使用 ASCII 字串來定義放置表格控制元素的位置。搜尋窗格的字母是 P - 例如

$('#myTable').DataTable({
    dom: 'Pftip',
    searchPanes:{
        // Your config here...
    },
});

這仍然適用於 DataTables 2(但不與layout同時使用 - 它們是互斥的),但建議您更新為使用layout

伺服器端處理

自搜尋窗格 1.1 版起,支援伺服器端處理(serverSide)。這將自動與免費和開放原始碼的 Editor 函式庫搭配使用。如果您想自己實作,可以使用伺服器端處理手冊頁面中提供的資訊。如需更多關於如何在沒有 Editor 的情況下設定 Editor 函式庫的資訊,請參閱此部落格文章,其中說明了如何操作。

功能

搜尋窗格新增以下功能

  • 更多的搜尋功能
  • 同時在多個窗格中搜尋
  • 可作為選項的自訂搜尋函式
  • 階層式窗格
  • 小計檢視
  • 完全國際化
  • 完全整合 Bootstrap、Foundation 和 DataTables 支援的其他樣式函式庫