Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 39 Next »

Description

ONGOING 

A text area is a multi-line text input control. 
Used when the expected user input is long. 

Usage & Behavior

General guidelines

Structure

The text area consists of:

  • Label - meaningful label of what information the user needs to provide

  • Input Field (the input field can display a hint text).

States

State

Default

Filled

Regular

Hover

Active

Disabled

Read Only

Error

Warning

Focused

Focused Hover

Focused Active

Interaction

  • Hover - hovering the text area will change the cursor to text cursor.

  • When text exists and the field is active -

    • Clicking the text area will place the cursor at the cursor position. 

    • Double clicking a word inside the text area will select that word.

    • Triple clicking the text area will select the whole text in the text area, if exists.

  • When text was not inserted and the field is active -

    • Clicking the field will place the cursor at the beginning and the hint text will disappear.

  • Non active - If no text was inserted, the hint text will be displayed again when the field will lose focus.

  • If a character limit was set, reaching the limit will prevent the user from keeping typing. 

  • In special cases, the text area height will be increased manually, according to the length of the text.

Validations and errors

Please refer to Field validation page for more information.

A text area with a warning will have an orange border and a warning icon, as displayed below: 

A text area with an error will have a red border and an error icon, as displayed below:

The orange/red border will be removed when the content is updated to a valid.

Best practices

  • For short input, use the text field component.

  • Always provide a clear and meaningful label for any input field.

  • Where appropriate, help users by providing hint texts which describes the expected value of the field.

Accessibility compliance

Unless otherwise specified, see our general compliance information in Fundamentals - Accessibility

Design

Zeplin link

Screen thumbnail

https://zpl.io/2v4yY7a



Code






  • No labels