All docs
V23.1
23.1
22.2
22.1
21.2
21.1
20.2
The page you are viewing does not exist in version 20.2. This link will take you to the root page.
20.1
The page you are viewing does not exist in version 20.1. This link will take you to the root page.
19.2
The page you are viewing does not exist in version 19.2. This link will take you to the root page.
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.
Box
Row
Map
Vue

changes

An array of pending row changes.

Type:

Object

Default Value: []
Raised Events: optionChanged

This array can be changed from the UI, with native JavaScript methods, or with UI component methods (addRow, editRow, editCell, deleteRow).

View Demo

data

An object with updated row fields.

Type: any

insertAfterKey

A key that identifies a record after which a new record should be inserted. Applies only if the type is "insert".

Type: any

The following code inserts a new record after a record with key 10:

JavaScript
changes.push({
    type: "insert",
    data: { ... },
    insertAfterKey: 10
});
IMPORTANT
Do not use insertAfterKey with insertBeforeKey.

View Demo

insertBeforeKey

A key that identifies the record before which a new record should be inserted. Applies only if the type is "insert".

Type: any

The following code inserts a new record before a record with key 5:

JavaScript
changes.push({
    type: "insert",
    data: { ... },
    insertBeforeKey: 5
});
IMPORTANT
Do not use insertBeforeKey with insertAfterKey.

key

The key of the row being updated or removed.

Type: any

The key property supports a simple and composite keys.

JavaScript
changes.push({
    type: 'update',
    data: { FirstName : 'name1', LastName: 'name2' }

    key: 1 // simple key
    // or ...
    key: {ID: 1, SecondID: 2} // composite key
});

type

Data change type.