editing

Configures editing.

Type:

Object

The widget allows a user to edit data in several modes, which are detailed in the mode option. To define what editing operations a user can perform, specify the allowAdding, allowUpdating and allowDeleting options. Before enabling an operation, make sure that your data source supports it.

NOTE
Editing works with plain data only.

Watch Video

See Also

allowAdding

Specifies whether a user can add new rows.

Type:

Boolean

Default Value: false
See Also

allowDeleting

Specifies whether a user can delete rows.

Type:

Boolean

Default Value: false

allowUpdating

Specifies whether a user can update rows.

Type:

Boolean

Default Value: false

form

Configures the form. Used only if editing.mode is "form" or "popup".

Default form editors depend on the columns' configuration. If the generated form does not meet your requirements, and you need to reorganize form items or set other form parameters, specify it in the form option. To link a form item with a grid column, assign identical values to the form.items.dataField and columns.dataField options.

NOTE

There are some form parameters that you cannot specify using this option:

See Also

mode

Specifies how a user edits data.

Type:

String

Default Value: 'row'
Accepted Values: 'row' | 'batch' | 'cell' | 'form' | 'popup'

The following list points out the differences in editing modes.

  • Row
    A user edits one row at a time. The widget saves changes when the row leaves the editing state. See demo.
  • Batch
    A user edits data cell by cell. The widget does not save changes until a user clicks the global "Save" button. See demo.
  • Cell
    Differs from the batch mode in that the widget saves changes when the cell leaves the editing state. See demo.
  • Form
    On entering the editing state, a row becomes a form with editable fields. The widget saves changes after a user clicks the "Save" button. See demo.
  • Popup
    Differs from the form mode in that the form with editable fields is placed in a popup window. See demo.

When using the widget as an ASP.NET MVC Control, specify this option using the GridEditMode enum. This enum accepts the following values: Row, Batch, Cell, Form and Popup.

popup

Configures the popup. Used only if editing.mode is "popup".

The popup always contains a form, whose items are used for editing. The popup object contains options that customize the popup itself (see their list in the Popup Configuration section). To customize the form items, use the form option.

View Demo

texts

Contains options that specify texts for editing-related UI elements.

Type:

Object