columnToggle

自：Buttons 1.0.0 起

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

描述

columnToggle 按鈕類型與 columnsToggle 按鈕非常相似，但它不是展開來顯示表格中每個欄位的單一按鈕，而是一個單一按鈕，可切換表格中一個或多個欄位的可見性（根據 columns 參數）。

對於多個欄位，應使用 buttons.buttons.text 選項為按鈕設定標題，此選項也可使用於單一欄位控制按鈕，但如果未另外提供，則會自動給予該欄位的標題文字。

選項

此按鈕可以在其組態物件中設定以下選項，以自訂其動作和顯示，此外，所有按鈕都可使用這些選項（例如：buttons.buttons.text）

名稱	類型	預設值
`action`
設定欄位的可見性。
`className`		buttons-columnVisibility
按鈕的類別名稱。請參閱 `buttons.buttons.className` 以了解詳細資訊。
`columns`		未定義
欄位選擇器，定義要包含在欄位可見性按鈕組中的欄位。預設情況下，這是 `未定義`，這會選取所有欄位，但可以使用任何 `欄位選擇器` 選項來定義自訂按鈕組。
`text`		由欄位標題定義
按鈕的顯示文字。預設情況下，這會使用此按鈕控制其可見性的欄位標頭文字（如果控制多個欄位，則會使用第一個欄位標題）。可以使用此選項設定文字（請參閱 `buttons.buttons.text`）。
`visibility`		未定義
要為選取的欄位設定的可見性值。`true` 會顯示該欄位，`false` 會隱藏該欄位，而 `未定義` 會切換其目前狀態。

範例

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'
				}
			]
		}
	}
});