SearchBuilder

SearchBuilder 為 DataTable 新增使用者定義的複雜搜尋,能夠透過建立群組和條件來搜尋 DataTable。這比 SearchPanes 或核心 DataTables 功能目前提供的搜尋控制更進階。可以為群組設定邏輯類型,並應用各種條件。

SearchBuilder 允許使用者透過在圖形介面中新增群組和條件來建構搜尋查詢,這個介面清晰易懂。SearchBuilder 已經內建一系列條件,可以應用於 DataTables 可辨識的所有資料類型。SearchBuilder 會自動辨識欄位類型,並呈現可用的條件。當然,這些條件都可以完全自訂以符合您的需求,並可根據需要擴充以支援自訂類型。

下載

取得和使用 SearchBuilder 最簡單的方法是使用 DataTables 下載建置器,您可以在其中選擇您希望在頁面上使用的軟體,並為您建立和託管單個 Javascript 和 CSS 檔案。除了選擇 SearchBuilder 套件外,您還必須新增相依的 DateTime 套件。

或者,也可以將個別檔案包含在您的頁面上,下載發佈套件,或者在 GitHub 上複製來源控制儲存庫

初始化

如果您在頁面上包含 SearchBuilder 擴充套件,則該頁面上的每個 DataTable 都會自動可以使用。您可以透過 searchBuilder 功能和 DataTables layout 選項來自訂 SearchBuilder 的位置並進行設定。

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

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

簡單的初始化將自動在您的表格上啟用 SearchBuilder。一些自訂選項包括:預定義搜尋、深度限制、欄位限制以及群組的預設邏輯。請參閱參考文件,以瞭解可用選項的完整詳細資訊。

請注意,也可以透過最上層的 searchBuilder 選項來設定 SearchBuilder。

舊版 dom 選項

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

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

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

功能

SearchBuilder 新增以下功能

  • 更強大的搜尋功能
  • 一次跨多個欄位進行複雜搜尋
  • 可輕鬆變更的邏輯運算子
  • 自訂條件
  • 完全國際化
  • 與 Bootstrap、Foundation 以及 DataTables 支援的其他樣式函式庫完全整合