buttons.buttons.text

自：Buttons 3.0.0 起

按鈕中顯示的文字。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

讓您的使用者知道在啟動按鈕時會發生什麼事情，對於 Buttons 擴充功能來說顯然至關重要，而此選項正好提供了這種能力。

類型

字串

描述: 要在按鈕內部顯示的 HTML 字串。這會以純 HTML 寫入文件，因此可以使用 HTML 進行額外的格式化。

function text( dt, node, config )

描述

buttons.buttons.text 按鈕選項可以定義為一個函式，該函式將在 Buttons 需要按鈕的文字時執行。這使外掛程式作者能夠利用 i18n() 來輕鬆地為按鈕中顯示的文字提供國際化支援。它也可能用於其他複雜的互動，例如計算選定列的數量。

參數

回傳

	名稱	類型	選填
1	`dt`	`DataTables.Api`	否
	主機 DataTable 的 DataTables API 實例
2	`node`	`jQuery`	否
	按鈕節點的 jQuery 實例
3	`config`	`物件`	否
	按鈕的設定物件

要顯示為按鈕視覺文字的字串

預設值

值：依按鈕類型而定

範例

設定按鈕的文字

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: [{ extend: 'copy', text: 'Copy to clipboard' }]
		}
	}
});

使用 i18n() 方法進行國際化：

new DataTable('#myTable', {
	layout: {
		topEnd: {
			buttons: [
				{
					extend: 'print',
					text: function (dt, button, config) {
						return dt.i18n('buttons.print', 'Print');
					}
				}
			]
		}
	}
});

實例初始化：使用 HTML 醒目提示操作鍵

new DataTable.Buttons(table, {
	buttons: [
		{
			extend: 'print',
			text: '<em>P</em>rint',
			key: {
				key: 'p',
				altkey: true
			}
		}
	]
});