buttons.buttons.key

自：Buttons 3.0.0

為按鈕定義啟動鍵。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充套件。

描述

Buttons 具有內建功能，可透過鍵盤按鍵和按鍵組合來啟動按鈕。這是為了協助無障礙功能，並提供表格的完整鍵盤導覽。例如，使用 Editor 時，無需觸摸滑鼠即可新增、編輯和刪除記錄！

只有在文件沒有處於活動焦點的元素時，才會處理按鍵。這表示在 input 元素中輸入時，不會意外觸發按鈕的動作！

類型

字串

描述: 作為字串，此選項會設定要監聽的按鍵。它應該是單一字元（因為無法同時按下多個字元！）。字元不區分大小寫。

物件

描述

此選項的物件形式提供對哪個按鍵（或哪些按鍵）將啟動特定按鈕的額外控制，並提供依 meta 鍵（例如 shift、alt 和 ctrl）定義篩選的選項。

可用的物件屬性如下：

key - 要監聽的字元。字元不區分大小寫。
shiftKey - 如果設定為 true，則僅在同時按住 shift 鍵時才會發生啟動。
altKey - 如果設定為 true，則僅在同時按住 alt 鍵時才會發生啟動。
ctrlKey - 如果設定為 true，則僅在同時按住 ctrl 鍵時才會發生啟動。
metaKey - 如果設定為 true，則僅在同時按住 cmd 鍵 (Mac) 或 Windows 鍵 (Windows) 時才會發生啟動。

如果您希望將啟動限制為特定的複雜按鍵組合，則可以定義多個選項。

預設值

值：undefined

範例

DataTables 初始化：為按鈕設定單一按鍵

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: [{ extend: 'print', key: 'p' }]
		}
	}
});

DataTables 初始化：需要 alt 鍵

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: [
				{
					extend: 'print',
					key: {
						key: 'p',
						altKey: true
					}
				}
			]
		}
	}
});