按鈕.按鈕

自：按鈕 3.0.0 起

要建立的按鈕清單。
請注意 - 此屬性需要 DataTables 的按鈕擴展功能。

描述

buttons.buttons 陣列定義了將在文件中顯示給最終使用者的按鈕。陣列中的每個元素可以是下列其中一種：

string - 內建按鈕類型或外掛按鈕類型的名稱。這相當於使用 { extend: ... }。
object - 自訂按鈕或現有按鈕類型的自訂。可以定義 extend 屬性 (請參閱 buttons.buttons.extend) 以告知「按鈕」要以哪個按鈕類型為基礎，以及任何您想要自訂的配置選項。或者，如果未指定 extend 選項，請使用 text 和 action 選項來定義按鈕。「按鈕」的每個按鈕只有少數幾個內建配置選項，但各種按鈕類型可能會提供其他選項。請參閱每個按鈕類型的文件，以取得有關它們提供的其他選項的資訊。內建選項如下：
- buttons.buttons.action - 描述啟用時要執行的動作的函式
- buttons.buttons.className - 按鈕類別名稱
- buttons.buttons.enabled - 初始啟用狀態
- buttons.buttons.extend - 基礎擴展物件
- buttons.buttons.init - 按鈕初始化回呼函式
- buttons.buttons.key - 按鍵啟用配置
- buttons.buttons.name - 用於選擇器的按鈕名稱
- buttons.buttons.text - 可見文字
function - 將在建立按鈕時執行的函式。該函式僅傳遞一個引數，即主機 DataTable 的 DataTables API 實例，而結果值應與上述選項或上述選項的陣列相符。

類型

陣列

描述: 此陣列定義要在按鈕集合中顯示的按鈕清單。陣列中的每個元素都可以採用多種選項，包括字串、物件和函式。請參閱上面的文件以取得完整詳細資訊。陣列可以包含多種類型的元素。

範例

按鈕 作為使用基本類型的陣列

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: ['copy', 'csv', 'print']
		}
	}
});

兩個按鈕，一個具有自訂

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: {
				buttons: ['copy', { extend: 'excel', text: 'Save as Excel' }]
			}
		}
	}
});

完全自訂的按鈕

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: {
				buttons: [
					'copy',
					{
						text: 'My button',
						action: function (dt) {
							console.log('My custom button!');
						}
					}
				]
			}
		}
	}
});

實例初始化：使用按鈕陣列

new DataTable.Buttons(table, {
	buttons: ['copy', { extend: 'excel', text: 'Save as Excel' }]
});