button().text()
自:Buttons 1.0.0 起
取得/設定所選按鈕的文字。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。
描述
此方法提供動態取得和設定一個或多個按鈕顯示文字的功能。如果互動(例如行選擇)變更了按鈕的行為,這會很有用,可以讓最終使用者知道該行為的變更。
類型
function button().text( set )
- 描述
設定所選按鈕的顯示文字
- 參數
名稱 類型 選填 1 set
否 要在所選按鈕中顯示的文字。這是以 HTML 寫入按鈕,因此可以使用 HTML 標籤,並會在按鈕中顯示呈現的結果。
也可以定義一個函式,每當 Buttons 更新按鈕顯示文字時,就會執行該函式,並將結果用作要在按鈕中顯示的文字。請參閱
buttons.buttons.text
以了解函式簽名。- 傳回值
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');
});