集合

自：按鈕 1.0.0

一個按鈕，觸發一個下拉選單，其中包含另一組按鈕。
請注意 - 此屬性需要 DataTables 的按鈕擴充套件。

描述

集合按鈕類型是按鈕的組成部分，因為它能夠在啟動按鈕時顯示一個或多個「子按鈕」的下拉選單。這提供了一種收集類似按鈕並以節省空間的方式向最終使用者顯示它們的方法。

此按鈕類型的關鍵方面是 buttons 選項，它是一個您想要在下拉選單中顯示的按鈕陣列。此處定義的按鈕與任何其他按鈕完全相同，也可以透過 API 存取和操作。

選項

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

名稱	類型	預設值
`action`
顯示集合
`align` 自：1.6.0		dt-container
相對於按鈕的彈出視窗的水平對齊方式。它可以是以下其中之一 `button-left` - 對齊啟動按鈕的左側。 `button-right` - 對齊啟動按鈕的右側。 `container` - 對齊 DataTables 容器的左側和右側（自 2.2.2 起） `dt-container` - 對齊 DataTables 容器的左側並跨越其完整寬度 - 已棄用，請使用 `container` 和 `span` 選項。
`autoClose` 自：1.1.2		false
當啟動集合內的按鈕時，自動關閉集合。
`background`		true
顯示 (`true`) 背景元素，可以使用 CSS 設定樣式，以淡化頁面其餘部分的方式在視覺上突出顯示集合，或不顯示 (`false`)。
`backgroundClassName`		dt-button-background
如果啟用背景元素，則要新增至背景元素的類別名稱。
`buttons`		[]
要在集合中顯示的按鈕。此陣列中的元素遵循與 `buttons.buttons` 陣列相同的規則 - 即它可以包含描述按鈕的字串、物件和函式。從按鈕 1.1 開始，這也可以包含觸發顯示其他集合的按鈕（即巢狀集合）。
`className`		buttons-collection
按鈕的類別名稱。有關詳細資訊，請參閱 `buttons.buttons.className`。
`collectionLayout`
集合中顯示的按鈕的版面配置選項。這是一個字串，可以具有位置 `dropdown` - 將集合從主機按鈕放下 `fixed` - 將集合顯示在視窗的中心欄版面配置 `columns` - 自動欄顯示（根據螢幕大小），最多四欄 `two-column` - 以兩欄顯示 `three-column` - 以三欄顯示 `four-column` - 以四欄顯示欄版面配置可以與下拉選單的預設絕對定位一起使用，或與固定位置版面配置選項一起使用。若要使用固定位置和多欄版面配置，只需以空格分隔選項 - 例如 `fixed columns`。
`collectionTitle` 自：1.5.4
已棄用，改用 popoverTitle - 將在 3.0.0 版中移除要在集合頂部顯示的文字字串。這對於多層集合很有用，以確保最終使用者知道目前選單指的是什麼。
`dropup`		false
當 `true` 時，下拉集合始終向上彈出。當 `false` 時，集合會根據可用的溢位向上或向下彈出。
`fade`		400
集合淡入和淡出顯示的動畫速度。這是一個整數值，表示動畫的持續時間，以毫秒為單位。若要不使用動畫，請使用值 `0`。
`popoverTitle` 自：2.0.0
要在集合頂部顯示的文字字串。這對於多層集合很有用，以確保最終使用者知道目前選單指的是什麼。
`postfixButtons`		undefined
應附加到現有集合的按鈕清單（請參閱 `buttons` 選項）。這提供了延伸集合的按鈕，以便將項目新增到集合子按鈕的結尾的功能。與 `buttons` 選項一樣，此陣列中的元素遵循與 `buttons.buttons` 陣列相同的規則。
`prefixButtons`		undefined
應在現有集合之前新增的按鈕清單（請參閱 `buttons` 選項）。這提供了延伸集合的按鈕，以便將項目新增到集合子按鈕的開頭的功能。與 `buttons` 選項一樣，此陣列中的元素遵循與 `buttons.buttons` 陣列相同的規則。
`span` 自：2.2.2		container
使下拉選單的寬度與 datatables 容器的寬度相符。 `預設值` - 集合下拉選單的寬度由 CSS 定義。 `container` - 跨越 DataTables 容器的完整寬度（適用於大型內容區域）。
`text`		集合
按鈕的顯示文字。可以使用此選項（請參閱 `buttons.buttons.text`）或 DataTables `language` 物件的 `buttons.print` 選項來設定文字。

範例

DataTables 初始化：建立匯出集合

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'collection',
					text: 'Export',
					buttons: ['csv', 'excel', 'pdf']
				}
			]
		}
	}
});