colvis

自：Buttons 1.0.0

提供列可见性控制的按钮集合。
请注意 - 此属性需要 DataTables 的 Buttons 扩展。

说明

此按钮将创建一个集合按钮，在激活时将显示表格中列的列表，并允许最终用户切换列可见性以适应他们自己的需求。

选项

此按钮可以在其配置对象中设置以下选项以定制其操作和显示，除了所有按钮都可用的那些选项（例如： buttons.buttons.text。

名称	类型	默认
`action`
显示控制列可见性的集合。
`className`		buttons-collection buttons-colvis
按钮的类名。有关详细信息，请参阅 `buttons.buttons.className`。
`columnText` 自：1.3.0		未定义
回调函数，可以修改或替换列表中每个按钮使用的文本。此函数针对每个按钮执行一次。它接受三个参数 `DataTable.Api`：DataTable API 实例 `integer`：正在创建的按钮的列数据索引 `string`：由 Buttons 创建的按钮的标题（来自列标题）返回值是 `string`，它将用于按钮的文本。
`columns`		未定义
列选择器，用于定义要在列可见性按钮集中包含的列。默认情况下，这是 `undefined`，这会导致选择所有列，但可以使用任何 `column-selector` 选项来定义自定义按钮集。
`sort` 自：3.1.3		未定义
指示应按列顺序（默认）还是按字母顺序显示显示的列按钮。要按字母顺序显示，请将此选项设置为 `alphabetic`。
`text`		列可见性
按钮的显示文本。可以使用此选项（请参阅 `buttons.buttons.text`）或 DataTables `language` 对象的 `buttons.colvis` 选项来配置文本。

示例

DataTables 初始化：显示具有默认选项的 colvis 按钮

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: ['colvis']
		}
	}
});

显示 colvis 按钮，但不将第一列包含在列的列表中

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'colvis',
					columns: 'th:nth-child(n+2)'
				}
			]
		}
	}
});

各个列按钮文本的自定义

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'colvis',
					columnText: function (dt, idx, title) {
						return idx + 1 + ': ' + title;
					}
				}
			]
		}
	}
});