捲軸滾動器
啟用並設定 DataTables 的捲軸滾動器擴充套件。
請注意 - 這個屬性需要 DataTables 的 捲軸滾動器 擴充套件。
說明
捲軸滾動器是 DataTables 的一個擴充套件,提供虛擬渲染支援 - 也就是說,它只會繪製表格中可見的一小部分(加上一小部分的重疊以實現平滑捲動),即使在捲動視窗中,對最終使用者而言,整個表格看起來都是可用的。這可以顯著提高大型資料集的效能,因為您不希望顯示分頁控制項。
使用捲軸滾動器時,有兩個重要的要求需要考慮
- DataTables 中必須啟用分頁功能 (
paging
- 預設是啟用) - 所有列的高度必須相等。這是為了計算尚未渲染的列的高度。
這個選項可以讓您啟用和設定 DataTables 的捲軸滾動器。最簡單的形式是使用布林值 true
,它會啟用具有預設設定選項的捲軸滾動器(由 $.fn.dataTable.Scroller.defaults
定義)。它也可以用作物件,以提供如下所述的自訂設定選項。
請注意,與捲軸滾動器的所有其他設定選項一樣,此選項是 預設 DataTables 選項集的擴充。此屬性應在 DataTables 初始化物件中設定。
類型
布林值
- 說明
作為布林值,此屬性將在正在建立的 DataTable 上啟用捲軸滾動器。
true
將啟用捲軸滾動器,而false
則不會。這是一個快捷選項,可以啟用具有預設設定選項的捲軸滾動器。可以通過將此參數設為物件進行自訂,請參閱下文。
物件
- 說明
如果以物件形式給出,則會在目標 DataTable 上啟用捲軸滾動器,並擴充預設值 (
$.fn.dataTable.Scroller.defaults
),並且可能會被此物件中提供的選項覆寫。這是在個別表格的基礎上,或通過預設值設定捲軸滾動器的方式。
預設值
- 值:
undefined
預設情況下不會初始化捲軸滾動器
範例
為表格啟用捲軸滾動器
new DataTable('#myTable', {
ajax: '/api/data',
scrollY: 300,
scroller: true
});
使用設定選項啟用捲軸滾動器
new DataTable('#myTable', {
ajax: '/api/data',
scrollY: 300,
scroller: {
loadingIndicator: true
}
});