API Docs

Field Change Event

Field Change Event - app.record.index.edit.change.(fieldcode)

An event triggered when a specified field value changes during an inline editing of a record on the record list.

Function

app.record.index.edit.change.(fieldcode)

Fields That Can Be Specified

  • *Single-line text
  • *Number
  • Radio button
  • Check box
  • Multi-choice
  • Drop-down
  • Date
  • Time
  • Date and time
  • User selection
  • Department selection
  • Group selection

*An event is triggered when the field loses focus or when a value is set via a lookup field.

Properties of the Event Object

PROPERTY TYPE DESCRIPTION
type String The event type.
Returns app.record.index.edit.change.(fieldcode).
appId Number The App ID.
record Object A record object including data inputted by the user at the time of the event.
For more information, refer to the following article:
Field Types
recordId Number The Record ID.
changes Object An object including data of changed fields and rows.
changes.field Object An object of the changed field.
For more information, refer to the following article:
Field Types
changes.row null Table row data.
Always returns null as table fields cannot be modified on the record list.

Available Event Object Actions

Running Actions after Waiting for Asynchronous Operations to Finish

By returning a Promise object, you can run actions after waiting for asynchronous operations to finish. Refer to the sample code on the following article:
Save Event

Limitations

  • This event is only available on the Desktop, and not on the mobile.
  • Events are not triggered for fields are not listed in the following section:
    Fields that can be specified
  • The value of a calculated field retrieved via the event object depends on whether the field is displayed in the record list:
    • If displayed in the list: Returns an empty string
    • If not displayed in the list: Returns the value before recalculation
  • Refer to the Limitations section of the following article:
    Event Handling