{hero}

按钮.按钮.拆分

自:按钮 3.0.0

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

描述

此选项允许所有 DataTables 按钮具有拆分按钮功能。

为了实现拆分按钮,只需扩展任何现有的按钮类型,以包括 buttons.buttons.split 配置选项,或将其包含在自定义按钮初始化中。此选项的值是一个数组,其中包含要作为辅助按钮添加的进一步按钮。此数组中的按钮可以与 buttons.buttons 选项采用相同的形式声明,请阅读该文档以获取更详细的信息。

自 Buttons 2.0.0 起,可以向集合中添加自定义 html。只需将包含 html 的字符串包含在 buttons.buttons.split 数组中,它将按该顺序插入到集合弹出框中。 此示例 展示了如何使用它来创建更强大的弹出框。

注意:在创建样式集成时,Bulma 不支持拆分按钮下拉菜单。因此,在 Bulma 中不支持拆分按钮。如果 Bulma 开始支持拆分按钮,将在未来更新。

类型

数组

描述

此数组包含要作为辅助按钮添加的更多按钮,这些按钮显示在弹出框中。此数组中的按钮可以与 buttons.buttons 选项采用相同的形式声明,请阅读该文档以获取更详细的信息。

默认

  • 值:未定义

示例

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

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

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

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

带有自定义按钮和内置按钮组合的拆分下拉按钮

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

弹出框中的自定义 HTML

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