colvisGroup

自：Buttons 1.0.0 起

顯示和隱藏多個欄位。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

當處理欄位可見性時，您可能希望向最終使用者呈現一個控制項，使其能夠同時設定多個欄位的顯示和隱藏 - 允許進行分組。 colvisGroup 按鈕類型為 Buttons 提供了此功能。此按鈕正好提供了這個選項。

此按鈕的 show 和 hide 參數都是 column-selector 類型，用於定義表格中應分別顯示或隱藏的欄位。如果某個欄位未在這兩者中定義，則其可見性不會改變。

請注意，與大多數其他按鈕不同，按鈕文字（buttons.buttons.text）選項沒有預先定義，因為沒有可以應用的合理預設值。您必須為此按鈕設定文字屬性。

選項

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

名稱	類型	預設
`action`
設定欄位可見性。
`className`		buttons-colvisGroup
按鈕的類別名稱。有關詳細資訊，請參閱 `buttons.buttons.className`。
`hide`		[]
要從可見顯示中移除的欄位
`show`		[]
要設為可見的欄位

範例

DataTables 初始化：使用類別名稱進行欄位分組

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'colvisGroup',
					text: 'Office info',
					show: '.office',
					hide: '.hr'
				},
				{
					extend: 'colvisGroup',
					text: 'HR info',
					show: '.hr',
					hide: '.office'
				}
			]
		}
	}
});

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

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'colvisGroup',
					text: 'Show all',
					show: ':hidden'
				},
				{
					extend: 'colvisGroup',
					text: 'Show none',
					hide: ':visible'
				}
			]
		}
	}
});