keys.enable()
始於:KeyTable 2.0.0
啟用或停用 KeyTable 的互動功能(滑鼠和鍵盤)。
請注意 - 這個屬性需要 DataTables 的 KeyTable 擴充功能。
描述
KeyTable 通常用作啟用 DataTable 其他互動選項的工具,例如編輯儲存格的內容或觸發動作以顯示有關儲存格或列的其他資訊。在這種情況下,重要的是我們能夠控制 KeyTable 自己的監聽器,以便根據您的情況精細控制它所作用的按鍵。此方法提供了這種能力。
當 KeyTable 完全啟用時,當儲存格獲得焦點時,它將監聽所有非特殊字元的按鍵(即 shift、cmd / ctrl 和 alt 會被忽略)並觸發 key
事件。但是,您可能希望停止 KeyTable 監聽某些事件,例如在編輯欄位時的字母。為了提供此功能,該方法接受一個可選參數,該參數將告知 KeyTable 您希望它監聽和作用於哪個級別的監聽器。
請注意,KeyTable 的按鍵監聽器會在 keydown
事件上觸發,如果 KeyTable 對按鍵執行動作(例如移動焦點),它將自動呼叫事件的 stopPropagation()
方法。
類型
function keys.enable( [ options ] )
- 描述
啟用終端使用者和 API 修改 DataTable 中焦點儲存格的功能。可透過可選參數使用不同級別的啟用。
- 參數
名稱 類型 可選 1 options
是 - 預設值:true 此選項可以指定為以下值
true
- 完全啟用 KeyTablefalse
- 完全停用 KeyTable (keys.disable()
)navigation-only
- 僅響應導航輸入
- 回傳值
DataTables API 實例
範例
僅允許導航(即字母鍵不執行任何動作且不觸發任何事件)
var table = new DataTable('#myTable', {
keys: true
});
table.keys.enable('navigation-only');
相關
以下選項直接相關,也可能對您的應用程式開發有用。