列按钮切换
自:Buttons 1.0.0
用于切换各个列可见性的按钮组。
请注意 - 此属性需要使用 Buttons 扩展用于 DataTables。
描述
此按钮类型实际上在 Button 实例中创建多个按钮,每个按钮对应一个选中的列(如果没有给定选择器,则对应所有列)。每个按钮自动获得与此列标题文本相同的标题,并提供了切换每列可见性的能力。
columnsToggle
按钮类型不同于 colvis
类型之处在于,它不扩展 collection
类型(虽然如果愿意,可以将它分配到集合的 buttons
属性)。每个列的按钮在此按钮包含的部分会自动展开。
选项
除了所有按钮都可以(例如 buttons.buttons.text
)使用的那些选项以外,此按钮可以在其配置对象中设置以下选项以自定其操作和显示
名称 | 类型 | 默认值 |
---|---|---|
列 | 未定义 | |
定义包含在列可见性按钮组中的列的选择器。默认情况下,此选项为 | ||
可见性 | 未定义 | |
为所选列设置的可见性值。 |
示例
DataTables 初始化:为每列显示一个按钮
new DataTable('#myTable', {
layout: {
topStart: {
buttons: ['columnsToggle']
}
}
});
DataTables 初始化:仅为具有“切换”类名的列显示按钮
new DataTable('#myTable', {
layout: {
topStart: {
buttons: [
{
extend: 'columnsToggle',
columns: '.toggle'
}
]
}
}
});