Label
Last updated
Last updated
The Label Web Control displays text to a user. Labels also accept unicode to add emojis or symbols.
Expects type text.
The text that is displayed on the Web Page.
The HTML tag that wraps the Label on the page for accessibility purposes. If empty, it defaults to a "span" tag. It does not affect how the Label is displayed.
To use the functionality associated with Input ID to connect this label to, this value must be set to label
Input ID to connect this label to
Expects type text.
The Input ID assigned to the Web Control bound to the Label.
Some Web Controls, such as the Text Input, Dropdown List, and Checkbox Web Controls are used to collect user input. When the Input ID assigned to one of these Input Controls is also assigned to this field, users can interact with the designated Input Web Control directly by clicking on the Label.
The value of the Format field must be set to label in order for a Label to be successfully bound to an Input Web Control.
For more on how to use the Input ID, see Connecting Labels to Input Controls.
Assigns an HTML tag to a label on a web page to be recognized by assistive technologies. The tags available for a Label are: h1, h2, h3, p, span, or label. When choosing Header 1 (h1), you have the option to make that header focusable.
Roles provide a semantic association to a Label, allowing assistive technologies to interact with that Label according to users' expectations. The roles available for a Label are: cell, definition, heading, math, none, note, presentation, separator, term, tooltip, alert, log, marquee, status, timer.
Expects type text.
Assigns a string value to a Label using an accessible name, for cases where the default denomination in the user interface is missing, or does not accurately describe its contents. For more information see here.
Designates a dynamic Label to be recognized by assistive technologies. A dynamic Label is an element that do not require the whole Web Page to reload in order to change. Users may choose one the following ARIA Live properties:
off: ARIA Live attribute is disabled.
Polite: assistive technologies will notify users of updates when they are idle, without interrupting their current task.
Assertive: any updates made to the Label are notified immediately.
Expects type boolean.
The ARIA Atomic attribute allows you to define if assistive technologies will recognize changes to the selected Label. If TRUE is selected, any dynamic change in the Label will be notified to the user. This property is FALSE by default.
This attribute establishes if the Label will trigger notifications by assistive technologies when they are modified. Users may choose one of the following ARIA Relevant properties:
additions: when text or content is added to the designated Label.
removals: when text or content is deleted from the designated Label.
text: when text is added inside the designated Label.
all: All of the abovementioned actions: additions, removals and text.
Expects type boolean.
If TRUE the Label will be visible. If FALSE the Label will not be displayed. If the field is empty, the Label will be visible.
Expects type boolean.
If TRUE the control will be disabled and the user will not be able to interact with it. If FALSE the control will be enabled. If the field is empty, the control will be enabled.
The default Label Variants allow builders to quickly choose among body or heading styles.
Check Common style properties of web controls for further details on how to style your Label Web Control.
To make a Label that displays different text depending on the value of variables, you must edit the Airscript expression that defines the text of the Label. Here's an example where we personalize a greeting by inserting the text variable first_name into the text by using double curly brackets to designate an Airscript expression for evaluation within a string:
In practice, you might not always have a value for first_name, so you can disable the Label using IF() and ISEMPTY() to check if there's a name and change the the text displayed in the Label accordingly.
