按钮.按钮.拆分

自：按钮 2.0.0

拆分下拉按钮。
请注意 - 此属性需要用于 DataTables 的按钮扩展。

说明

此属性是功能属性 buttons.buttons.split 的一个别名，可用于从最高级别的 DataTables 配置对象而非在 layout 选项（参见下面的示例）配置功能。此操作可让你将该功能作为字符串而不是对象使用，但如果你使用多个该功能实例，它会限制配置。有关此选项适用的详细信息和选项，请参阅 buttons.buttons.split 的文档。

如果你正在使用不带有此 layout 选项的 DataTables 1.x，请使用此属性名称，但请参阅 buttons.buttons.split 的文档以获取详细信息。

示例

用于打印选项的拆分下拉按钮

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

带有自定义按钮的拆分下拉按钮

new DataTable('#myTable', {
	layout: {
		topStart: 'buttons'
	},
	buttons: [
		{
			text: 'High priority',
			action: function () {
				/* ... */
			},
			split: [
				{
					text: 'Medium priority',
					action: function () {
						/* ... */
					}
				},
				{
					text: 'Low priority',
					action: function () {
						/* ... */
					}
				}
			]
		}
	]
});

使用自定义按钮和内置按钮的拆分下拉按钮

new DataTable('#myTable', {
	layout: {
		topStart: 'buttons'
	},
	buttons: [
		{
			text: 'High priority',
			action: function () {
				/* ... */
			},
			split: [
				'pdf',
				{
					text: 'Medium priority',
					action: function () {
						/* ... */
					}
				},
				{
					text: 'Low priority',
					action: function () {
						/* ... */
					}
				}
			]
		}
	]
});

弹出窗口内的自定义 HTML

new DataTable('#myTable', {
	layout: {
		topStart: 'buttons'
	},
	buttons: [
		{
			extend: 'collection',
			className: 'custom-html-collection',
			buttons: [
				'<h3>Export</h3>',
				'pdf',
				'csv',
				'excel',
				'<h3 class="not-top-heading">Column Visibility</h3>',
				'colvis'
			]
		}
	]
});