{hero}

select.style

自:Select 1.0.0 起

設定終端使用者與表格互動的選取樣式。
請注意 - 這個屬性需要 DataTables 的 Select 擴充功能。

描述

Select 提供多種不同的內建方式,讓終端使用者可以與表格中項目的選取互動,此參數控制這些方式(以及初始化後的 select.style())。

預設的操作模式是基於現代作業系統中檔案的選取方式,其中可以使用 ctrl/cmd 和 shift 鍵來提供複雜的操作。

請注意,雖然 api 選項會停用透過 Select 內建事件處理常式進行的項目選取,但仍然可以使用 API,根據您自己的事件處理常式,為終端使用者提供選取/取消選取項目的能力。

類型

字串

描述

此選項可以採用以下其中一個值

  • api - 只能透過 API 執行選取
  • single - 只能選取單個項目,當選取新項目時,任何其他選取的項目將自動取消選取
  • multi - 可以選取多個項目。選取方式只需點擊要選取的項目
  • os - 作業系統 (OS) 樣式選取。這是最全面的選項,並提供複雜的行為,例如按住 ctrl/cmd 點擊以選取/取消選取個別項目,按住 shift 點擊以選取範圍,以及未修改的點擊以選取單個項目。
  • multi+shift - os 樣式和 multi 之間的一種混合,允許輕鬆進行多行選取,而不會在點擊行時立即取消選取。

預設

  • 值:os

範例

透過 Select 的點擊事件處理常式停用終端使用者選取

new DataTable('#myTable', {
	select: {
		style: 'api'
	}
});

僅啟用單個項目選取

new DataTable('#myTable', {
	select: {
		style: 'single'
	}
});