{hero}

按鈕

自:按鈕 3.0.0

表格控制按鈕。
請注意 - 此屬性需要 DataTables 的 按鈕 擴展。

描述

DataTables 的按鈕擴展可以輕鬆地將一組按鈕添加到 DataTable,以提供對表格中資料的控制。按鈕提供了一組按鈕,可用於將表格中的資料匯出為各種格式和基本的表格控制,但更普遍地說,它建立了一個框架,可供 DataTables 的其他擴展使用,以提供一種定義控制按鈕的通用方式。

類型

陣列

描述

大多數按鈕配置並非關心 DOM 配置和按鈕提供的其他選項,而是關心呈現哪些按鈕以及它們如何單獨構建。因此,為了提供一個快捷方式,此選項可以作為陣列提供。此陣列將自動對應到 buttons.buttons 選項。

例如,以下兩個配置在功能上是相同的

// Using `buttons` as an array
new DataTable('#myTable', {
    layout: {
        topStart: {
            buttons: [ 'copy', 'csv', 'excel' ]
        }
    }
} );
// Using `buttons.buttons`
new DataTable('#myTable', {
    layout: {
        topStart: {
            buttons: {
                buttons: [ 'copy', 'csv', 'excel' ]
            }
        }
    }
} );

物件

描述

作為一個物件,此選項可以配置一個 DataTables 按鈕擴展的單個實例,該實例將在 DataTable 初始化時建立。 有關此物件中可用的完整參數範圍,請參閱按鈕初始化參考的其餘部分。

範例

使用預設值建立按鈕

new DataTable('#myTable', {
	layout: {
		topStart: 'buttons'
	}
});

使用按鈕陣列建立按鈕

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

使用物件配置建立按鈕

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: {
				name: 'primary',
				buttons: ['copy', 'csv', 'excel']
			}
		}
	}
});