删除

从版本：编辑器 1.5.0 开始

使用编辑器删除一行或多行数据的按钮。
请注意——此属性需要适用于 DataTables 的编辑器扩展。

说明

由编辑器提供remove按钮类型可通过预定义按钮轻松删除 DataTable 中一行或多行已选择行，该按钮会调用remove()方法触发数据删除。

它使用适用于 DataTables 的选择扩展确定在 DataTable 中选择的数据，并将该信息提供给remove()方法，以便删除该数据。

remove()方法表单选项可用的所有选项都可通过按钮选项（即formButtons、formMessage和formTitle）获得。

此按钮要求必须设置editor选项，该选项告知按钮在激活时应在哪个编辑器实例上执行操作。通过这种方式，如果需要，可以将多个编辑器实例附加到一个 DataTable 上。

选项

除了那些可用于所有按钮的选项之外（例如buttons.buttons.text），此按钮还可以在其配置对象中设置以下选项以自定义操作和显示。

名称	类型	默认值
`editor`
此按钮在激活时应在哪一个编辑器实例上执行操作。
`formButtons`
在通过`remove`按钮激活时在编辑器表单中显示的表单控件按钮（即提交、取消等）。此处给出的值将直接传递给`buttons()`方法——请参考该方法的文档，还请参考`button-options`数据类型。
`formMessage`
在删除表单中显示的信息。这可以是简单的字符串或函数，在按钮激活时计算字符串并显示。此处给定的值直接传递给`message()`方法。有关可用选项的详细信息，请参考该方法的文档。
`formOptions`
配置表单行为的表单选项 - 参见 `form-options` 了解详情。此处指定的选项将优先于通过 `formOptions.main` 配置的任何选项。
`formTitle`
用于给出移除表单的标题。这可以是一个简单的字符串或将在激活按钮时计算要显示的字符串的函数。此处给定的值直接传递给 `title()` 方法。请参阅该方法的文档以全面了解可用选项。

示例

针对编辑器实例 myEditor 的一个简单的 remove 按钮

new DataTable('#myTable', {
	buttons: [
		{
			extend: 'remove',
			editor: myEditor
		}
	]
});

创建、编辑和移除按钮，全部采用默认选项

new DataTable('#myTable', {
	buttons: [
		{ extend: 'create', editor: myEditor },
		{ extend: 'edit', editor: myEditor },
		{ extend: 'remove', editor: myEditor }
	]
});

一个带取消按钮的移除按钮

new DataTable('#myTable', {
	buttons: [
		{
			extend: 'remove',
			editor: myEditor,
			formButtons: [
				{
					label: 'Cancel',
					fn: function () {
						this.close();
					}
				},
				'Delete data'
			]
		}
	]
});

基于所选数据具有自定义消息的删除按钮

new DataTable('#myTable', {
	buttons: [
		{
			extend: 'edit',
			editor: myEditor,
			formMessage: function (editor, dt) {
				var rows = dt
					.rows({ selected: true })
					.data()
					.map(function (rowData) {
						return rowData.first_name;
					});

				return (
					'Are you sure you want to delete the data for users ' +
					rows.join(', ') +
					'?'
				);
			}
		}
	]
});