field().labelInfo()
Get / set label information for the field.
Please note - this property requires the Editor extension for DataTables.
Description
A short description explaining a field can often be beneficial to let users know what a field is used for, and thus what data is expected from them. This method can be used to get / set a field's label information (which is shown directly under the label itself - fields.label / field().label()).
Label information can be set when it is initially added to the form using the fields.labelInfo option. This API method extends that ability by providing a method to get and set the field information message any point after a field has been added to the form.
Editor provides three different elements for information display in each field, which can be used independently of each other, or in conjunction as required by your user interface design:
fields.message/field().message(): Dynamic information about a field that is typically updated based on user input. This is shown below the field's user input area.fields.fieldInfo/field().fieldInfo(): Very similar to the message option, but typically used for static information about an input - e.g. explaining what format is expected, or what the input value is used for.fields.labelInfo/field().labelInfo(): Information message shown below the field'slabelelement.
Types
field(…).labelInfo()
field(…).labelInfo( info )
Set the label information text for the field
Parameters:
| Name | Type | Optional | |
|---|---|---|---|
| 1 | info | No | |
Information text to show under the label for the field. To remove an existing message, pass in an empty string ( Additionally, a function can be given as the message, which will be executed by Editor with the returned value being used as the message to display. The function is passed two parameters:
| |||
Returns:
DataTable.Editor.Field: Field instance
Examples
Show a description string explaining what a field does.:
editor
.field('user')
.labelInfo('The user name is what the system user will login with');Clear an information message:
editor.field('user').labelInfo('');Related
The following options are directly related and may also be useful in your application development.