Youtap Tech Indonesia
Breadcrumbs

Multi Line - Text Input

Version history

Version

Date

Comment

Current Version (v. 1)

Oct 03, 2023 01:36

@Unknown user

Introduction

Text input fields are a fundamental element in user interfaces that allow users to input text or data into a digital application or form. Text input fields enable users to provide input for various purposes, such as entering their name, email address, password, or other information, and are commonly used in a wide range of digital interfaces, including websites, mobile apps, desktop applications, and more. Text input fields play a crucial role in user interaction and data collection, as they facilitate communication between users and digital applications.

Figma component - Text input


This section includes the following:

https://www.figma.com/file/F1fNT99VGTJHJ1jAnjFTn6/Youtap-Style-guide-V1.0.2023?node-id=870%3A69165&t=bSOwWTQGqqzPHGGC-1



01. Specifications

Standard States

Multi-line input fields should be used when the user has to enter more than one line of input and, therefore, the input needs to stretch across multiple ones.

Default State

Default
Frame 35011.png

1 - Variant A - No Value

text-multi-noValue

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - tertiary-black-60

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label1

margin-left - SP_2

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - null

2 - Variant B - Value

text-multi-value

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - tertiary-black-60

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center to outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - not null

input colour - primary

input size - body1

margin - SP_2

alignment - left


Error
error1.png

1 - Variant A - No Value

text-multi-noValue-error

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary2

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label1

margin-left - SP_2

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - null

2 - Variant B - Value

text-multi-value-error

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary2

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center on outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - not null

input colour - primary

input size - body1

margin - SP_2

alignment - left


Hover State

Default
Hover1.png

1 - Variant A - No Value

text-multi-noValue-hover

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - tertiary-black-80

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label1

margin-left - SP_2

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - null



text-multi-value-hover

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - tertiary-black-80

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center to outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - not null

input colour - primary

input size - body1

margin - SP_2

alignment - left


Error
error2.png


1 - Variant A - No Value

text-multi-noValue-hover-error

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary2

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label1

margin-left - SP_2

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - null

2 - Variant B - Value

text-multi-value-hover-error

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary2

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center on outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - not null

input colour - primary

input size - body1

margin - SP_2

alignment - left


Focused State

Default
Focus1.png

1 - Variant A - No Value

text-multi-noValue-focused

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary1

outline-weight - 2pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center to outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - null

2 - Variant B - Value

text-multi-value-focused

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary1

outline-weight - 2pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center to outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - not null

input colour - primary

input size - body1

margin - SP_2

alignment - left


Error
error7+t.png

1 - Variant A - No Value

text-multi- noValue-focused-error

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary2

outline-weight - 2pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center to outline

margin-left - SP_2

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - null

2 - Variant B - Value

text-multi-value-focused-error

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - secondary2

outline-weight - 2pt, inside

Background

background - tertiary-white

Label

label colour - primary

label size - label2

position - center to outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - primary

Input

input type - text

value - not null

input colour - primary

input size - body1

margin - SP_2

alignment - left


Inactive State

inact1.png

1 - Variant A - No Value

text-multi-noValue-inactive

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - tertiary-black-60

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - tertiary-black-60

label size - label1

position - center to outline

margin-left - SP_2

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - tertiary-black-60

Input

input type - text

value - null

2 - Variant B - Value

text-multi-value-inactive

Specifications

Size

width - 327px

height - auto (120px)

Radius

corner-rad - see radius

Outline

outline colour - tertiary-black-60

outline-weight - 1pt, inside

Background

background - tertiary-white

Label

label colour - tertiary-black-60

label size - label2

position - center to outline

margin-left - SP_1

padding inside field - 4px each side

background - tertiary-white

alignment - left

Mandatory indicator

asterisk colour - tertiary-black-60

Input

input type - text

value - not null

input colour - tertiary-black-60

input size - body1

margin - SP_2

alignment - left


Options for ALL multi-line input field types

Option A - Input value (mapped out above)

Example - NO

Example - YES

Screenshot 2023-04-18 at 12.43.15 PM.png

text-multi-noValue

Screenshot 2023-04-18 at 12.43.25 PM.png

text-multi-value

Use when

  • User has not entered a value into the input field yet.

Use when

  • User starts to enter value into the input field.

Don’t use

  • when there is an input value.

Don’t use when

  • There is no value input from the user yet.


Possible combinations

This option can be combined with all other options.


How to find variant in Figma
Figma option
MultiFigma.png


Change the input type to either

  • Multi-manual OR

  • Multi-auto


It will automatically change the size to

  • ‘Multi’ or

  • ‘Normal-auto’




Option B - Mandatory/ Required fields

Example - NO

Example - YES

Screenshot 2023-04-18 at 1.07.38 PM.png

text-multi-noValue-noReq

Screenshot 2023-04-18 at 12.43.15 PM.png

text-multi-noValue

Use when

  • Textfield is not required to complete a process, but is additional information that supports the customer experience.

Use when

  • Textfield is essential to completing the process and can’t be skipped.

  • The use of this will trigger an error and keep buttons inactive until information is given.

Don’t use when

  • Textfield is essential to completing a process and can’t be skipped.

Don’t use when

  • Textfield is optional information that adds to the customer experience, but is not essential.


Specifications

The mandatory/ required state is indicated by an asterisk (*) at the end of the label.

Screenshot 2023-04-27 at 9.00.56 AM.png

Text style - style of the related label (for this instance: label1)

Text colour - style of the related label (for this instance: primary)


Possible combinations

This option can be combined with all other options


How to find variant in Figma
Figma variations
ReqFigma.png

When a textfield should be required, the ‘required’ can be switched on.

The default state should be switched off.


Option C - Error state

Example - NO

Example - YES

Screenshot 2023-04-18 at 12.43.15 PM.png

text-multi-noValue

Screenshot 2023-04-18 at 12.55.49 PM.png

text-multi-noValue-error

Use when

  • Customer entered the correct value into the input field.

  • There has not been an error check triggered yet.

Use when

  • Customer entered wrong input AND error check was triggered.

Don’t use when

  • Customer entered WRONG input and error check was triggered.

Don’t use when

  • Customer entered the correct value into the input field.

  • No error check has been triggered.


Possible combinations

This option can be combined with all other options.


How to find variant in Figma

Figma Playground → https://www.figma.com/file/F1fNT99VGTJHJ1jAnjFTn6/Youtap-Style-guide-V1.0.2023?type=design&node-id=1361%3A69988&t=rkaRCEh0IZ21rS40-1

Figma variations
ErrorFigma2.png

When the value is not matching for a required field, it fires an error. This 'error’ state can be switched on and off.

The default state should be switched off.



Option D - Start Adornment (sA)

Example - NO

Example - YES

Screenshot 2023-04-18 at 12.43.15 PM.png

text-multi-noValue

Screenshot 2023-04-18 at 1.11.24 PM.png

text-multi-noValue-sA

Use when

  • There is no icon related to the information needed from the user.

  • Spacing is limited.

Use when

  • Icon is representative of the information required.

Don’t use when

  • Icon can support the information that is required by the customer.

Don’t use when

  • Spacing is limited.

  • Icon does not represent the information needed by the customer.

Specifications for Start Adornment
Screenshot 2023-04-27 at 9.12.13 AM.png

Icon size - 24x24px

Colour - needs to be set in the primary colour scheme


Possible combinations

This option can be combined with all other options


How to find variant in Figma

Figma Playground → https://www.figma.com/file/F1fNT99VGTJHJ1jAnjFTn6/Youtap-Style-guide-V1.0.2023?type=design&node-id=1361%3A69988&t=rkaRCEh0IZ21rS40-1

Figma variations
sAFigma2.png


A multi-line textfield can have a start adornment. The default state is switched off.


When switched on, an icon can be selected from our icon library that supports the context of the textfield.


Option E - Help text

Example - NO

Example - YES

Example - YES

Screenshot 2023-04-18 at 12.43.15 PM.png

text-multi-noValue

Screenshot 2023-04-18 at 1.26.07 PM.png

text-multi-value-help

Screenshot 2023-04-24 at 10.51.14 AM.png

text-multi-value-default-error-help

Use when

  • There is no additional information to tell to the customer.

  • There is no further action required by the customer.

Use when

  • Customer requires further information for what to input

Use when

  • There is an error that is essential to rectify before moving on.

Don’t use when

  • Customer requires extra information, e.g. the textfield is mandatory.

Don’t use when

  • There is no further information needed by the customer.

  • There is an error that is essential to rectify before moving on.

Don’t use when

  • The information is only additional, not essential to the customer.


Specifications
Screenshot 2023-04-20 at 10.17.00 AM.png

Text size - label2

Text colour - primary (for inactive - tertiary-black-60)


Possible combinations

This option can be combined with all other options.


How to find variant in Figma

Figma Playground → https://www.figma.com/file/F1fNT99VGTJHJ1jAnjFTn6/Youtap-Style-guide-V1.0.2023?type=design&node-id=1361%3A69988&t=rkaRCEh0IZ21rS40-1

Figma variations
sAFigma2.png


A multi-line textfield can have a start adornment. The default state is switched off.


When switched on, an icon can be selected from our icon library that supports the context of the textfield.



Option I - Active/ Inactive

Example - active

Example - inactive

Screenshot 2023-04-18 at 2.29.39 PM.png

text-multi-value - active

Screenshot 2023-04-18 at 2.30.16 PM.png

text-multi-value-inactive

Use when

  • Customer is required to give input to the textfield.

  • Customer is allowed to enter information into the given textfield.

Use when

  • Customer is not allowed to change value of the textfield.

  • Customer has not yet completed the input for textfields that are required before current textfield becomes active.

Don’t use when

  • Customer is not allowed to change value of the textfield.

  • Customer needs to fill out other textfields first before editing the related textfield.

Don’t use when

  • Customer is allowed to edit the input value of this textfield.


Possible combinations

This option can be combined with the ALL options EXCEPT:

  • Option C - Error state


How to find variant in Figma

Figma Playground → https://www.figma.com/file/F1fNT99VGTJHJ1jAnjFTn6/Youtap-Style-guide-V1.0.2023?type=design&node-id=1361%3A69988&t=rkaRCEh0IZ21rS40-1

Figma variations
InactiveFigma2.png

A multi-line textfield can be inactive if the user is not allowed to change the input. The default state is switched off.



02. Usage and behaviour

Standard States

Default state
Default
default2.png
Use when

Don’t use when

  • Customer is not interacting with the textfield.

  • Customer has selected the textfield.

  • Customer has entered text input to the textfield.

Error
error4.png

Use when

Don’t use when

  • Customer is not interacting with the textfield.

  • Customer has completed a step and it is a final validation of the input within the text field.

  • Textfield is mandatory/ required.

  • Customer has currently selected the textfield in which the error occurred.



Hover state (Desktop ONLY)
Default
hover2.png

Use when

Don’t use

  • Customer hovers their mouse over the textfield.

  • in any other circumstance besides hovering on desktop.


Error
error5.png

Use when

Don’t use when

  • Customer hovers their mouse over the textfield that fired an error.

  • in any other circumstance besides hovering over a textfield with an error indication on desktop.



Focus state
Default
focus2.png

Use when

Don’t use when

  • Customer is typing within the textfield.

  • The current textfield is selected by the customer.

  • Customer has not selected the textfield.


Error
error7.png

Use when

Don’t use when

  • Customer is typing within the textfield that has an error.

  • The current textfield is selected by the customer.

  • The current textfield is selected by the customer, but does not have an error.

  • Customer has not selected the textfield that has an error.



Inactive state
inactive2.png

Use when

Don’t use when

  • Customer is not allowed to make changes to input.

  • Customer has not yet finished the steps that they’d needed to complete before activating the textfield.

  • Customer is allowed to edit the textfield.

  • Customer is required to enter input to the textfield.


03. Interaction behaviour

Whenever there is a form the textfields follow the following order of states:

Input field variant

Visual reference

User behaviour

DEFAULT BEHAVIOUR

Default Var A →

Screenshot 2023-04-18 at 12.43.15 PM.png

User has not yet selected the input field and there is no input yet.

→ Focused Var A →

Screenshot 2023-04-18 at 12.49.55 PM.png

User selects current input field and starts entering the required value of the field.

→ Default Var B

Screenshot 2023-04-18 at 12.43.25 PM.png

User has finished their input and moved on to another input field.


ERROR IS TRIGGERED

Error Var A

Screenshot 2023-04-18 at 12.55.49 PM.png

User has not yet given input to a required field, but has pressed a CTA to move forward OR started entering value for the next input field. (this usually includes a helptext)

Error Var B

Screenshot 2023-05-16 at 10.02.21 AM.png

User has added value to the input field, however, it does not match the input. (This usually includes a helptext)


HELP TEXT GETS DISPLAYED

Error Help Text

Screenshot 2023-04-24 at 11.30.29 AM.png

User has entered the wrong input and gets an error message.


First editable input field on a page

This input field is automatically set to Focused Var A.


📱

04. Accessibility

For textfields, follow the WCAG2.0 - AA standard for colour, readability and other relevant considerations for textfields.


05. Resources