button().text()
自:按钮 1.0.0 起
获取/设置所选按钮的文字。
请注意 - 此属性要求 DataTables 的按钮扩展。
说明
此方法提供了动态获取和设置一个或多个按钮的显示文字的功能。这在交互(比如行选择)改变按钮行为时非常有用,以让最终用户知道行为的这种改变。
类型
function button().text()
- 说明
获取所选按钮的显示文字。
请注意,如果按钮的文字选项被指定为一个函数,这个方法将会执行该函数并返回结果,因此始终会返回字符串。
- 返回
按钮当前的显示字符串。
function button().text( set )
- 说明
设置所选按钮的显示文字
- 参数
名称 类型 可选 1 set
否 在所选按钮中显示的文字。这将作为 HTML 写入按钮中,因此可以使用 HTML 标记,并且会在按钮中以渲染方式显示。
还可以定义一个函数,每次按钮更新按钮显示文字时都会执行这个函数,并且该结果用作要在按钮中显示的文字。有关函数签名,请参见
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');
});