preBlur
Form blur event - triggered when the form loses focus (cancellable).
Please note - this property requires the Editor extension for DataTables.
Description
Emitted before a form blur occurs. A blur is an optional form close action, typically triggered by user interaction with the page, such as clicking on the form background, although it can also be triggered by blur().
The blur can either close the form (close()) or trigger a submission (submit()) depending on the form-options configured for the form.
This event is cancellable by returning false from the event handler, which will block any further action from happening (i.e. the close or submit), leaving the form in its existing state.
Event naming / backwards compatibility note
Prior to Editor 1.3, events were prefixed with the string on and this event was called onpreBlur. That event name can still be used, and will function exactly the same way as the event documented here. The new name is used for simplicity and coherence with the event naming conventions in DataTables.
Type
function( e )
Parameters:
| Name | Type | Optional | |
|---|---|---|---|
| 1 | e | No | |
Event object | |||
Returns:
boolean:
Return false to stop any blur action (close or submit) from happening. This will leave the form in the same state that it previously was.
Related
The following options are directly related and may also be useful in your application development.