Intro
A label is the name or title of a control or group of related controls.
Usage
Use the label control if:
- You need a label for a control. We recommend that you always use labels for form controls.
Do not use the label control if:
- You want to insert a heading in the column header of a table.
- You want to use it as an alternative for the text control, such as in display-only forms; do not use the label to display the data.
Types
Required Labels
To indicate that a field is mandatory, you can set the property “required”. An asterisk will be automatically set in front of the label.
Note: A colon is automatically set in front of the label when used in forms.
Mandatory label in a form
Guidelines
- Always use a label for form controls.
- Use title case for labels.
- Do not use a placeholder (input prompt) as a replacement for the label.
- If a label is used within a form, the colon is set automatically; otherwise, you need to set it manually.
- Do not use bold labels.
Exceptions
The layout can sometimes be simplified by using a placeholder instead of the label control. This exception can be applied in the following cases:
- When the form pattern is easily understood, such as on a login screen. Since this screen consists of only two input controls (username and password), the labels do not have to be used.
- When the form is extremely small and has fewer than three input fields, such as in messaging and small feedback forms.
- In search fields. For more information, see search.
Resources
Want to dive deeper? Follow the links below to find out more about related controls, the SAPUI5 implementation, and the visual design.