field().val()

Since: Editor 1.3

Get / set the value of a field. Please note - this property requires the Editor extension for DataTables.

The full Editor reference documentation is available to registered users of Editor - the information shown below is a summary only. If you already have an Editor license please , alternatively an Editor license can be purchased on this site, or sign up for the free trial.

Description

It is often useful to be able to get and set the value of a field, for example in client-side validation, or data manipulation. This method provides that ability.

When used while multi-row editing, this method has the following behaviour:

  • As a getter:
    • If all items being edited have the same value for this field, that value is returned
    • If the items being edited have different values for this field, undefined is returned. field().multiGet() should be used to access individual values if this is the case.
  • As a setter:
    • The field value is set to the same value for all items being edited. Use field().multiSet() to set individual values if required.

In addition to this method, Editor provides a number of other methods that can be used to get and set field values - each with their own speciality. Please refer to the Related selection below for links to these methods.