移除

自：Editor 1.5.0 起

一個使用 Editor 刪除一或多列的按鈕。
請注意 - 此屬性需要 DataTables 的 Editor 擴充功能。

描述

remove 按鈕類型由 Editor 提供，可讓您透過預先定義的按鈕輕鬆移除 DataTable 中一或多個選取的列，該按鈕將呼叫 remove() 方法來觸發資料刪除。

它使用 DataTables 的 Select 擴充功能來判斷 DataTable 中選取的資料，並將該資訊提供給 remove() 方法以刪除該資料。

remove() 方法的表單選項所有可用的選項都可以透過按鈕選項來使用（即 formButtons、formMessage 和 formTitle）。

此按鈕需要設定 editor 選項，該選項會告知按鈕在啟用時要操作哪個 Editor 實例。透過這種方式，如果需要，可以將多個 Editor 實例附加到單個 DataTable。

選項

除了所有按鈕可用的選項（例如 buttons.buttons.text）之外，此按鈕還可以在其組態物件中設定以下選項來自訂其動作和顯示。

名稱	類型	預設值
`editor`
此按鈕在啟用時應操作的 Editor 實例。
`formButtons`
當由 `remove` 按鈕啟用時，要在 Editor 表單中顯示的表單控制按鈕（即提交、取消等）。此處給定的值會直接傳遞給 `buttons()` 方法 - 請參閱該方法的說明文件以及 `button-options` 資料類型。
`formMessage`
要在移除表單中顯示的訊息。這可以是一個簡單的字串，或是一個將在按鈕啟用時計算要顯示的字串的函數。此處給定的值會直接傳遞給 `message()` 方法。有關可用選項的完整詳細資訊，請參閱該方法的說明文件。
`formOptions`
用於配置表單行為的表單選項 - 有關完整詳細資訊，請參閱 `form-options`。此處指定的選項將優先於 `formOptions.main` 配置的任何選項。
`formTitle`
要給移除表單的標題。這可以是一個簡單的字串，或是一個將在按鈕啟用時計算要顯示的字串的函數。此處給定的值會直接傳遞給 `title()` 方法。有關可用選項的完整詳細資訊，請參閱該方法的說明文件。

範例

適用於 Editor 實例 myEditor 的單個簡單移除按鈕

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(', ') +
					'?'
				);
			}
		}
	]
});