columnsToggle

自：Buttons 1.0.0 起

一組按鈕，用於切換個別欄位的可見性。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

此按鈕類型實際上會在一個按鈕實例中建立多個按鈕，每個選定的欄位一個按鈕（如果沒有給定選擇器，則為所有欄位）。每個按鈕都會自動獲得與該欄位的標題文字相同的標題，並且可以切換每個欄位的可見性。

columnsToggle 按鈕類型與 colvis 類型不同，它不會擴充 collection 類型（儘管如果您希望，它可以分配給集合的 buttons 屬性）。當包含此按鈕時，每個欄位的按鈕會自動展開。

此按鈕可以在其配置物件中設定以下選項，以自訂其動作和顯示，此外還有適用於所有按鈕的選項（例如 buttons.buttons.text）

名稱	類型	預設
`columns`		undefined
欄位選擇器，定義要包含在欄位可見性按鈕集合中的欄位。預設值為 `undefined`，這會導致選取所有欄位，但是可以使用任何 `column-selector` 選項來定義自訂按鈕集合。
`visibility`		undefined
要為選定欄位設定的可見性值。`true` 會顯示欄位，`false` 會隱藏欄位，而 `undefined` 會切換其目前狀態。

DataTables 初始化：顯示每個欄位的按鈕

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

DataTables 初始化：僅顯示類別名稱為 'toggle' 的欄位按鈕

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