==== edit ==== .. js:function:: edit() **domain**: client **language**: javascript **class** :doc:`Item class ` Description =========== Enables editing of data in the dataset. After a call to edit, an application can enable users to change data in the fields of the record, and can then post those changes to the item dataset using :doc:`post ` method, and then apply them to database using :doc:`apply ` method. The ``edit`` method * checks if the item dataset is active, otherwise raises exception * checks if the item dataset is not empty, otherwise raises exception * checks whether the item dataset is already in edit state, and if so, returns * if item is a :doc:`detail ` , checks if the master item is in edit or insert :doc:`state ` , otherwise raises exception * if item is not a :doc:`detail ` , checks if it is in browse :doc:`state ` , otherwise raises exception * triggers the :doc:`on_before_edit ` event handler if one is defined for the item * puts the item into edit :doc:`state ` , enabling the application or user to modify fields in the record * triggers the :doc:`on_after_edit ` event handler if one is defined for the item See also ======== :doc:`Modifying datasets `