编辑

自：编辑器 1.5.0

使用“编辑器”编辑一个或多个现有行的按钮。
请注意 - 此属性需要编辑器DataTables 扩展。

描述

edit 由编辑器添加到 DataTables 的按钮类型，并提供一个预定义按钮，它将调用 edit() 方法来触发对数据表中所选行的编辑。

它使用 DataTables 中的 Select 扩展来确定数据表中选择了哪些数据，并将该信息提供给 edit() 方法来编辑该数据。

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

此按钮要求必须设置 editor 选项，该选项告诉按钮在激活时操作哪个编辑器实例。这样，如果需要，可以将多个编辑器实例附加到单个数据表。

选项

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

名称	类型	默认值
`editor`
此按钮激活时应操作的编辑器实例。
`formButtons`
使用 `edit` 按钮激活时在编辑器表单中显示的表单控件按钮（即提交、取消等）。此处给定的值将直接传递到 `buttons()` 方法 - 请参阅该方法的文档以及 `button-options` 数据类型。
`formMessage`
在编辑表单中显示的消息。这可以是一个简单的字符串，也可以是一个函数，它将计算一个字符串，以便在激活按钮时显示该字符串。此处给定的值直接传递到 `message()` 方法。请参阅该方法的文档以了解所有可用选项的详细信息。
`formOptions`
表单选项可配置表单的行为 - 请参阅 `form-options` 以了解详细信息。此处指定的选项将优先于由 `formOptions.main` 配置的任何选项。
`formTitle`
给予编辑表单的标题。这可以是一个简单的字符串，也可以是一个函数，它将计算一个字符串，以便在激活按钮时显示该字符串。此处给出的值被直接传递到 `title()` 方法。有关可用选项的全部详情，请参阅该方法的文档。

示例

适用于 Editor 实例 myEditor 的单个简单编辑按钮

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

创建、编辑和删除按钮，全部带有默认选项

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

一个带有取消按钮的编辑按钮

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

一个使用函数的自定义标题的编辑按钮

new DataTable('#myTable', {
	buttons: [
		{
			extend: 'edit',
			editor: myEditor,
			formTitle: function (editor, dt) {
				// Get the data for the row and use a property from it in the
				// form title
				var rowData = dt.row({ selected: true }).data();

				return 'Editing data for ' + rowData.first_name;
			}
		}
	]
});