csv

自：Buttons 1.0.0 起

建立並儲存包含表格資料的 CSV 檔案。
請注意 - 此屬性需要 DataTables 的 Buttons 擴充功能。

描述

此按鈕類型作為一個代理，將根據瀏覽器的功能和頁面上可用的函式庫，自動偵測是否可以使用 csvHtml5 按鈕。

提供此選項是因為 HTML5 按鈕類型需要相當現代化的瀏覽器，而使用者可能不一定可以使用。

如果沒有滿足 csvHtml5 按鈕的需求，則不會向使用者顯示任何按鈕。有關每個按鈕類型的需求，請參閱其各自的文件。

選項

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

名稱	類型	預設值
`action`
建立並儲存 CSV 檔案。
`bom` 自：1.2.2 起		false
選項，是否包含 UTF-8 位元組順序標記 (`true`) 或不包含 (`false`)。預設情況下會停用此選項，因為Unicode 標準指出，UTF-8 不需要也不建議使用 BOM。
`charset`		null
用於檔案匯出的字元集。當使用 `null` (預設值) 時，將會讀取並使用文件的字元集 (`document.characterSet`)。可以將此屬性設定為 `false` 來停用新增字元集的功能。
`className`		buttons-csv buttons-html5
按鈕的類別名稱。有關詳細資訊，請參閱`buttons.buttons.className`。
`customize` 自：1.1.1 起		undefined
可以用於修改匯出資料內容的函式。此函式接收兩個參數：按鈕配置的資料以及按鈕的配置物件。函式傳回的值將會用於匯出。如果您希望在匯出的資料中新增公司標頭或頁尾、描述資料或任何其他資訊，此功能特別有用。從 Buttons 1.5.2 開始，此函式會傳遞三個參數 CSV 資料為字串按鈕配置物件按鈕所屬表格的 DataTables API 執行個體。
`escapeChar`		"
用作 CSV 資料跳脫字元的字元。此字元會被加在與 `fieldBoundary` 選項設定相符的欄位中找到的任何資料之前。這是一個可設定的選項，因為不同的應用程式可能需要不同的選項 - 但是預設值符合 RFC4180。
`exportOptions`		{}
選取要從 DataTable 收集以進行匯出的資料。這包括要匯出的欄位、列、排序和搜尋的選項。有關詳細資訊，請參閱 `buttons.exportData()` 方法 - 此參數提供的物件會直接傳遞到該動作中以收集所需的資料。
`extension`		.csv
給予所建立檔案的副檔名。
`fieldBoundary`		"
用於括住複製到系統剪貼簿的表格純文字表示法中每個欄位的字元。這會自動新增到每個儲存格資料的開頭和結尾。
`fieldSeparator`		,
用於分隔複製到系統剪貼簿的表格純文字表示法中欄位的字元。
`filename`		*
給予所建立檔案的名稱（加上 `extension` 選項定義的副檔名）。特殊字元 `*` 會自動替換為從主機文件的 `title` 標籤讀取的值。
`footer`		false
指示是否應將表格頁尾包含在匯出的資料中。
`header`		true
指示是否應將表格標頭包含在匯出的資料中。
`newline`		\n
用於分隔資料行的字元。請注意，在 Windows 用戶端上，預設值為 `\r\n`。所有其他平台則預設為只有 `\n`。
`text`		CSV
按鈕的顯示文字。可以使用此選項設定文字（請參閱 `buttons.buttons.text`），或使用 DataTables `language` 物件的 `buttons.copy` 選項。

範例

DataTables 初始化：使用 HTML5 CSV 按鈕

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

DataTables 初始化：使用 exportOptions 儲存所有資料，無論篩選條件為何

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'csv',
					text: 'Copy all data',
					exportOptions: {
						modifier: {
							search: 'none'
						}
					}
				}
			]
		}
	}
});