Grid Cells Editing

jqxGrid Cell Editing feature much resembles the data entering experience in an Excel Spreadsheet – once you select a grid cell, you can enter data when you start typing text.
The Grid's 'editable' property specifies whether the editing is enabled or not.

Mouse Edit Actions

• Single mouse click: Marks the clicked cell as selected and shows the editor. The editor's value is equal to the cell's value.
• Single mouse click on a selected cell: Marks the cell as selected and shows the editor.
• Double mouse click on a cell: Marks the cell as selected and shows the editor. The editor's value is equal to the cell's value.

Keyboard Edit Actions and Navigation

If the user starts typing text, the cell's content is replaced with the text entered from the user.

• Left Arrow key is pressed - Selects the left cell, when the Grid is not in edit mode. Otherwise, the key stroke is handled by the editor.
• Right Arrow key is pressed - Selects the right cell, when the Grid is not in edit mode. Otherwise, the key stroke is handled by the editor.
• Up Arrow key is pressed - Selects the cell above, when the Grid is not in edit mode. Otherwise, the key stroke is handled by the editor.
• Down Arrow key is pressed - Selects the cell below, when the Grid is not in edit mode. Otherwise, the key stroke is handled by the editor.
• Page Up/Down is pressed - Navigate Up or Down with one page, when the Grid is not in edit mode. Otherwise, the key stroke is handled by the editor.
• Home/End is pressed - Navigate to the first or last row, when the Grid is not in edit mode. Otherwise, the key stroke is handled by the editor.
• Enter key is pressed - Shows the selected cell's editor. If the cell is in edit mode, hides the cell's editor and saves the new value. The editor's value is equal to the cell's value.
• Esc key is pressed - Hides the cell's editor and cancels the changes.
• Tab key is pressed - Selects the right cell. If the Grid is in edit mode, saves the edit cell's value, closes its editor, selects the right cell and opens its editor.
• Shift+Tab keys are pressed - Selects the left cell. If the Grid is in edit mode, saves the edit cell's value, closes its editor, selects the left cell and opens its editor.
• F2 key is pressed - shows the selected cell's editor.
• Space key is pressed - Toggles the checkbox editor's check state when the selected cell's column is a checkbox column.

Programmatic Editing

The Grid have APIs for showing and hiding the cell editors.
The 'begincelledit' method allows you to put a specific cell into edit mode.


The 'endcelledit' method ends the edit operation and confirms or cancels the changes.
The following code cancels the changes:


The following code cancels the changes:


To set a new value to a Grid cell, you can use the 'setcellvalue' method:


To get the value of a Grid cell, you can use the 'getcellvalue' method:


The 'cellbeginedit' and 'cellendedit' events are raised when the edit operation begins or ends.


...
Editor Types

jqxGrid supports the following types of editors:

• TextBox
• CheckBox(uses the jqxCheckBox widget)
• NumberInput(uses the jqxNumberInput widget and edits currency, percentange and any type of numeric information)
• DateTimeInput(uses the jqxDateTimeInput widget and edits date and time values)
• DropDownList(uses the jqxDropDownList widget and selects a single value from a list of values)

To specify the column's editor, you should set the column's 'columntype' property to 'textbox', 'dropdownlist', 'numberinput', 'checkbox' or 'datetimeinput'. To disable the editing of a specific grid column, you can set the column's editable property to false. The 'initeditor' function is called when the editor's widget is initialized. It allows you to use the properties of the widget and make it best fit your application's scenario.


Validation

The Grid will display a validation popup message when the new cell's value is not valid. The developers are able to set a custom validation logic and error messages for each grid column. The Grid will stay in edit mode until a correct value is entered or the user presses the "Esc" key.

In following code, the "Ship Date", "Quantity" and "Price" columns define custom validation functions. Each function has 2 parameters - the edit cell and its value. Depending on your logic, you can validate the value and return true if the value is correct or false, if the value is not correct. You can also return an object with 2 members - result and message. The message member represents the message that your users will see, if the validation fails.