搜尋窗格
搜尋窗格會在 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 支援的其他樣式函式庫