blur()

Blur the currently displayed editor.
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 sign-in, alternatively an Editor license can be purchased on this site, or sign up for the free trial.

Description

An Editor blur is very similar to a close (see close()) as they can both trigger the form to be closed, however, a blur is an indirect operation, while a close is a direct and immediate operation. For example, when the Editor lightbox display controller is shown, the end user can directly close the form by clicking on the close icon in the top right, or the form can potentially be closed by clicking on the background of the HTML document - this is a blur.

Additionally, the blur action's behaviour can be modified by the form-options options that are used to display the form. For example, the form-options.submitOnBlur option can be used to have the form automatically submit when blurred. This can be useful when using inline() particularly if keyboard navigation is your primary input method.

This method will primarily be of use to developers who wish to create their own display controller, and want to be able to offer the same functionality of the built in controllers, with regard to being able to close and blur a form.