| Table of Contents |
|---|
Description
...
State | Default | Filled |
|---|---|---|
Regular |  |  |
Hover |  |  |
Active |  |  |
Disabled |  |  |
Read Only |  |  |
Error |  |  |
Warning |  |  |
Focused |  |  |
Focused, Hover |  |  |
Focused, Active |  |  |
Focused, Disabled |   |   |
Interaction
On hover over the text field, the mouse cursor will change to a text cursor.
On click:
where no text has been added to the field:
a text cursor will appear at the beginning of the text field.
the hint text will disappear.
where text already exists in the field:
a text cursor will appear in the position where the user clicks.
double-clicking a word inside the text field will select that word.
triple-clicking the text field will select all of the text.
As text is entered it will appear from the left-hand side.
Text characters may be masked (secured text field only).
Once the cursor reaches the end of the field, it will stop and new characters will be added at that point. The start of the text string will disappear on the left-hand side of the field.
If a character limit has been set, reaching the limit will prevent the user from entering any more characters.
When the user clicks away and the field becomes inactive:
if the text string exceeds the width of the field, the start of the text string will come back into view.
if no text has been added the hint text will reappear.
Validations and errors
Please refer to the Field Validation page for more information.
A text field with a warning will have an orange border and a warning icon, as shown below:
...
the user needs to enter dates and times → use a Date Picker or a Time Picker.
the user needs to increase or decrease a numeric value → use aNumeric Stepper.
the user needs to enter a lot of text → use a Text Area.
the user needs to perform a search → use a Search Field.
...
Always provide a clear and meaningful preceding Label for any input field.
Where appropriate, help users by providing a guiding/hint text describing the expected input text.
When the user is filling in a secured text field, allow them to temporarily view the text.
Accessibility compliance
A text field must have a label, an icon or a button which indicates its purpose.
Unless otherwise specified, see our general compliance information in Fundamentals - Accessibility.
...