{hero}

message()

Since: Editor 1.0

Show / hide an information message for the whole form, or a specific 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 can often be helpful to end users if fields, particularly complex fields, have information messages either explaining what the data in the field represents, or how a particular input control operates. Equally, general information messages explaining what a form is used for, can often prove to be useful.

This method provides the ability to set a global form information message, an information message for a specific field, or to remove any existing information messages.

Note that the field().message() method introduced in Editor 1.3 provides the same functionality as this method for individual fields. Both forms will continue to be supported in future versions of Editor, and they can often be used interchangeably for single fields. The key difference is in the return value - this method will return a DataTables.Editor instance, while the field().message() method returns a DataTables.Editor.Field instance. This can affect how you chain methods if you are using the returned value for chaining.