Skip to end of banner
Go to start of banner

Text Area

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