{hero}

捲軸滾動器

啟用並設定 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
	}
});