colvis

自：Buttons 1.0.0 起

提供欄位可見性控制的按鈕集合。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

此按鈕將建立一個集合按鈕，啟用後會顯示表格中的欄位清單，並讓使用者能夠切換欄位可見性以符合他們自己的需求。

選項

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

名稱	類型	預設值
`action`
顯示集合以控制欄位可見性。
`className`		buttons-collection buttons-colvis
按鈕的類別名稱。詳情請參閱 `buttons.buttons.className`。
`columnText` 自：1.3.0 起		undefined
回呼函式，可修改或取代清單中每個按鈕使用的文字。此函式會針對每個按鈕執行一次。它接受三個參數 `DataTable.Api`：DataTable API 實例 `integer`：正在建立的按鈕的欄位資料索引 `string`：Buttons 建立的按鈕標題（衍生自欄位標題）傳回值是一個 `string`，將用於按鈕的文字。
`columns`		undefined
欄位選擇器，定義要包含在欄位可見性按鈕集合中的欄位。預設值為 `undefined`，這會導致選取所有欄位，但可以使用任何 `column-selector` 選項來定義自訂的按鈕集合。
`sort` 自：3.1.3 起		undefined
指出顯示的欄位按鈕應依欄位順序（預設）或字母順序顯示。若要依字母順序顯示，請將此選項設定為 `alphabetic`。
`text`		欄位可見性
按鈕的顯示文字。可以使用此選項（請參閱 `buttons.buttons.text`）或 DataTables `language` 物件的 `buttons.colvis` 選項來設定文字。

範例

DataTables 初始化：使用預設選項顯示 colvis 按鈕

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

顯示 colvis 按鈕，但不包含欄位清單中的第一個欄位

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'colvis',
					columns: 'th:nth-child(n+2)'
				}
			]
		}
	}
});

自訂個別欄位的按鈕文字

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'colvis',
					columnText: function (dt, idx, title) {
						return idx + 1 + ': ' + title;
					}
				}
			]
		}
	}
});