{hero}

button().text()

自:Buttons 1.0.0 起

取得/設定所選按鈕的文字。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

此方法提供動態取得和設定一個或多個按鈕顯示文字的功能。如果互動(例如行選擇)變更了按鈕的行為,這會很有用,可以讓最終使用者知道該行為的變更。

類型

function button().text()

描述

取得所選按鈕的顯示文字。

請注意,如果按鈕的文字選項指定為函式,此方法將執行該函式並傳回結果,因此始終會傳回字串。

傳回值

按鈕的目前顯示字串。

function button().text( set )

描述

設定所選按鈕的顯示文字

參數
傳回值

DataTables API 實例,結果集中包含所選按鈕,可用於對按鈕進行進一步的鏈接操作。

範例

取得按鈕索引 1 的文字

var table = new DataTable('#myTable');
var buttonText = table.button(1).text();

使用動作顯示按鈕啟動計數器

var table = new DataTable('#myTable');
var button = table.button(0);
var counter = 0;

button.text('Click counter: 0').action(function () {
	counter++;
	this.text('Click counter: ' + counter);
});

使用函式顯示文字

var table = new DataTable('#myTable');

table.button(0).text(function (dt, button, config) {
	return dt.i18n('buttons.input', 'Input');
});