buttons().text()
自:Buttons 1.0.0
获取/设置选定按钮的文本。
请注意 - 此属性需要 DataTables 的 按钮 扩展。
说明
此方法提供了动态获取和设置一个或多个按钮显示文本的能力。当交互(例如行选择)更改按钮的行为时,这非常有用,它可以让最终用户知道此行为有哪些改变。
类型
函数 buttons().text()
- 说明
获取所选按钮的显示文本。
请注意,如果按钮的 text 选项指定为一个函数,此方法将执行该函数并返回结果,因此始终返回一个字符串。
- 返回值
一个 DataTables API 实例,其中结果集包含所选按钮的文本。
函数 buttons().text( set )
- 说明
设置选定按钮的显示文本
- 参数
名称 类型 可选 1 set
否 选定按钮中显示的文本。被写入到按钮中的 HTML 中,因此 HTML 标记可以使用并且将被显示为在按钮中呈示。
还可以定义一个函数,每当 Buttons 更新按钮显示文本时该函数将被执行,并且结果将被用作要在按钮中显示的文本。有关函数签名,请参阅
buttons.buttons.text
。- 返回值
DataTables API 实例,其中结果集中包含所选按钮,可用于对按钮进行进一步操作。
示例
获取所有按钮的文本
var table = new DataTable('#myTable');
var buttonText = table.buttons().text();
console.log(buttonText.toArray());
使用 HTML 设置所有禁用按钮的文本
var table = new DataTable('#myTable');
table.buttons('.disabled').text('<b>Not available</b>');
使用函数显示文本
var table = new DataTable('#myTable');
table.buttons([0, 1]).text(function (dt, button, config) {
return dt.i18n('buttons.input', 'Input');
});