欄位可見性

自：按鈕 1.0.0 起

一個控制一個或多個欄位可見性的單一按鈕。
請注意 - 此屬性需要 DataTables 的按鈕擴充功能。

描述

此按鈕類型會建立一個單一按鈕，可以控制 DataTale 中一個或多個欄位的可見性（其對應的 columnsVisibility 將會針對每個欄位展開為一個單獨的按鈕）。這提供了擁有顯示全部/隱藏全部按鈕的能力，可以控制表格的所有欄位或這些欄位的子集。

對於多個欄位，應該使用 buttons.buttons.text 選項為按鈕指定標題，此選項也可以用於單欄控制按鈕，儘管如果沒有另外提供，則會自動給定欄位的標題文字。

選項

除了所有按鈕可用的選項（例如 buttons.buttons.text）之外，此按鈕的設定物件中可以設定以下選項，來自訂其操作和顯示。

名稱	類型	預設值
`columns`		未定義
欄位選擇器，用於定義要包含在欄位可見性按鈕集中的欄位。預設情況下，這是 `undefined`，這會導致選擇所有欄位，但是可以使用任何 `欄位選擇器` 選項來定義自訂的按鈕集。
`visibility`		未定義
控制在啟動按鈕時是否應顯示或隱藏欄位。

範例

DataTables 初始化：顯示全部/隱藏全部按鈕

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'columnVisibility',
					text: 'Show all',
					visibility: true
				},
				{
					extend: 'columnVisibility',
					text: 'Hide all',
					visibility: false
				}
			]
		}
	}
});