建立

自：Editor 1.5.0 起

一個使用 Editor 建立新列的按鈕。
請注意 - 此屬性需要 DataTables 的 Editor 擴充功能。

描述

create 按鈕類型由 Editor 提供，並提供一個易於使用的介面來呼叫 create() 方法，透過預先定義的按鈕。所有可用的 create() 方法的表單選項，都可以透過按鈕選項來設定（即 formButtons、formMessage 和 formTitle）。

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

選項

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

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

範例

針對 Editor 實例 myEditor 的單個簡單 create 按鈕

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

建立、編輯和移除按鈕，全部使用預設選項

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

具有取消按鈕的建立按鈕

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

具有自訂訊息的建立按鈕

new DataTable('#myTable', {
	buttons: [
		{
			extend: 'create',
			editor: myEditor,
			formMessage:
				'Enter the data for the new row and click the "Save" button below to save permanently.'
		}
	]
});

建立

描述

選項

範例

相關

DataTables