excel

自：Buttons 1.0.0

创建并保存一个包含表格数据 Excel CSV 文件。
请注意 - 这个属性需要 DataTables 的按钮扩展。

说明

此按钮类型作为代理服务器自动检测，基于浏览器的功能和页面上可用的库，excelHtml5 按钮是否可用。

提供此选项是因为 HTML5 按钮类型需要相当现代的浏览器，而该浏览器可能并不总是对最终用户可用。

如果 excelHtml5 按钮的需求未得到满足，则不会向最终用户显示任何按钮。对于每种按钮类型，请参阅其自有文档。

样式和定制

有关如何自定义创建的 XLSX 文件，请参阅 excelHtml5 按钮中定制部分的文档。

选项

除了可用于所有按钮的选项（如 buttons.buttons.text），此按钮还可以在其配置对象中设置以下选项，以便定制其操作和显示

名称	类型	默认值
`action`
创建和保存一个 Excel 文件。
`className`		buttons-excel
按钮的类名。详情请见 `buttons.buttons.className`。
`createEmptyCells` 自：1.5.0		false
指示 Excel 导出创建空单元格的选项。默认情况下，如果单元格包含 `null` 或空数据，它将不会在导出的电子表格中创建。但是，基于样式要求，您可能希望这样做。
`customize` 自：1.2.0		undefined
此方法可以用于修改 Buttons 创建的 XSLX 文件。传入的第一个参数是一个对象，其中包含 XML 文件，该对象的结构与 XSLX 文件中这些文件的路径相匹配。XSLX 文件的定制是一个复杂的话题 - 有关全部细节，请参阅 `excelHtml5` 按钮文档中的定制部分。自 Buttons 1.5.2 起，此函数传入三个参数一个对象，其中包含 Excel 使用的 ZIP 文件结构中的 XML 文件按钮配置对象属于此按钮的数据表的一个 DataTables API 实例。
`exportOptions`		{}
选择要从 DataTable 收集用于导出的数据。这包括哪些列、行、排序和搜索的选项。有关详细信息，请参见 `buttons.exportData()` 方法，由此参数给定的对象直接传入该动作中以收集所需的数据。
`extension`		.xlsx
要给创建的文件取的扩展名。
`filename`		*
给创建的文件指定的文件名（加上 `extension` 选项定义的扩展名）。特殊字符 `*` 会自动替换为从宿主文档的 `title` 标记中读取的值。
`footer`		false
指示是否在导出的数据中包括表脚注。
`header`		true
指示是否在导出的数据中包括表头。
`messageBottom` 自 1.4.0 起		*
显示在表底部或 `caption` 标记（如果显示在表底部）底部的信息。
`messageTop` 自 1.4.0 起		*
显示在表顶部或 `caption` 标记（如果显示在表顶部）顶部的信息。
`sheetName`		Sheet1
创建的 Excel 文件中工作表的名称。不允许使用字符 [] \ /: *? :，如果存在则会将其删除。
`text`		Excel
按钮显示的文本。可以使用这个选项（见 `buttons.buttons.text`）或 DataTables 的 `buttons.copy` 选项配置文本。`language` 对象。
`title` 自 1.4.0 起		*
将包含在导出数据中的表的标题。有关此参数的所有选项，请参见 `buttons.exportInfo()`。

示例

DataTables 初始化：使用 excel 按钮类型自动将 HTML 按钮选项定义为别名。

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

DataTables 初始化：使用 exportOptions 仅保存当前 DataTable 页面上显示的数据

new DataTable('#myTable', {
	layout: {
		topStart: {
			buttons: [
				{
					extend: 'excel',
					text: 'Save current page',
					exportOptions: {
						modifier: {
							page: 'current'
						}
					}
				}
			]
		}
	}
});