{hero}

keys.clipboard

自:KeyTable 2.4.0 起

啟用/停用 KeyTable 的剪貼簿互動功能。
請注意 - 此屬性需要 DataTables 的 KeyTable 擴充功能。

描述

KeyTables 為 DataTable 提供類似試算表的導覽功能,通常用於編輯資料。與複製和貼上系統命令的互動是此導覽功能的自然延伸,從 v2.4 開始,KeyTable 支援複製和貼上命令。

如果頁面上沒有選取任何其他文字,且當然僅在有焦點的儲存格時,複製命令才會複製焦點儲存格內的文字。否則,將會套用瀏覽器的預設行為。預設情況下,複製的文字是顯示的呈現文字。可以使用 keys.clipboardOrthogonal 參數來控制此行為。

貼上命令會將目前剪貼簿中的文字放入儲存格。如果表格上啟用了 Editor (keys.editor),則會針對該儲存格啟動 Editor,然後寫入並提交該值。如果表格上未啟用 Editor,則會使用 cell().data() 將值寫入儲存格。只有當儲存格具有 KeyTable 焦點,且頁面上沒有任何活動元素(即具有焦點的 input)時,才會執行貼上命令。

類型

布林值

描述

一個布林值旗標,可以用來選擇性地停用 KeyTable 的剪貼簿互動功能。

預設值

  • 數值:true

終端使用者可以從 KeyTable 焦點儲存格複製和貼上值。

範例

停用剪貼簿互動功能

new DataTable('#myTable', {
	keys: {
		clipboard: false
	}
});

相關

以下選項直接相關,在您的應用程式開發中可能也很有用。