列切换

自：Buttons 1.0.0

一个单按钮，用于切换一个或多个列的可见性。
请注意 - 此属性需要 Buttons 扩展用于 DataTables。

描述

columnToggle 按钮类型与 columnsToggle 按钮非常相似，但它不会展开以显示表中每列的单个按钮，而是一个单按钮，用于切换表中一个或多个列的可见性（根据 columns 参数）。

对于多列，应该给按钮一个标题，使用 buttons.buttons.text 选项，该选项也可用于单个列控制按钮，尽管如果没有另行提供，它将自动获取该列的标题文本。

选项

除了可用于所有按钮的选项外（例如 buttons.buttons.text），此按钮可以在其配置对象中设置以下选项以自定义其动作和显示

名称	类型	默认值
`action`
设置列的可见性。
`className`		buttons-columnVisibility
按钮的类名。有关详细信息，请参见 `buttons.buttons.className`。
`columns`		undefined
列选择器，用于定义要包含在列可见性按钮集中的列。默认情况下，此值为 `undefined`，这会导致选择所有列，但任何 `column-selector` 选项均可用于定义自定义按钮集。
`text`		由列标题定义
按钮的显示文本。默认情况下，这将使用该按钮控制其可见性的列的标题文本（或如果它控制多列，则使用第一个列标题）。可以使用此选项配置文本（参见 `buttons.buttons.text`）。
`visibility`		undefined
要为选定列设置的可见性值。`true` 将显示该列，`false` 将隐藏该列，`undefined` 将切换其当前状态。

示例

DataTables 初始化：仅切换列索引 1 的可见性

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'columnToggle',
					columns: 1
				}
			]
		}
	}
});

DataTables 初始化：两个按钮，用于切换具有类 primary 和 secondary 的所有列的可见性

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'columnToggle',
					columns: '.primary'
				},
				{
					extend: 'columnToggle',
					columns: '.secondary'
				}
			]
		}
	}
});