{hero}

columnsVisibility

自:Buttons 1.0.0

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

說明

此按鈕類型實際上會在按鈕實例中建立多個按鈕,針對每個已選取的欄位(如果未給定選擇器,則為所有欄位)建立一個按鈕。每個按鈕都會自動獲得與該欄位的標題文字相同的標題,並能透過按鈕的 visibility 選項來控制每個欄位的可見性。

此按鈕類型包含在基本欄位可見性按鈕集中,以求完整性,但 columnsTogglecolumnVisibility 通常更有用。

選項

除了適用於所有按鈕的選項(例如,buttons.buttons.text)之外,此按鈕還可以在其配置物件中設定以下選項,以自訂其動作和顯示方式。

範例

DataTables 初始化:用於顯示/隱藏欄位的個別按鈕集合

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