Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourBlue
titleDone

...

  • Syntax validation - validation should be displayed while typing. For example:

    • an illegal character was typed  (e.g. numbers instead of alphabetic)

    • exceed the number of characters (e.g. user input 3 digit number where only 2 digits is allowed)

  • Logical validation - any validation that is set on the required value (e.g. Max. input of 100)

    • In most cases, the validation will occur after the user left the field

  • Missing input on a required field

    • Validation is displayed as soon as the user leaves the input field (out of focus) the required input field which has no input

    • one exception is when a form has a single required field. In this case, the validation will appear only after the user tries to submit the form (Submit enabled)

...

  • Back - returns the focus to the field with the last used input 

  • Revert - returns the focus to the field with the latest valid input (the one before the user changed it)

    See pop-up example:

Structure

The field validation consists of:

  • Color frame or  & a Small  icon on the top right corner - marks the validation type

  • A  validation tooltip message appears upon hover of the validated field/component 

  • A descriptive message next to the submit button

    • Error messages have a higher priority than a warning. In case the error was fixed, the warning validation should be presented.

    • In some cases of limited space or a short form, no descriptive message will appear

Examples:

Components


Error

Warning

Text field

Text area

Dropdown menu

Combo box (free text field)

Spinner (free text field)

Date Picker (free text field)

Time Picker (free text field)

Search field

NA

Toggle

NA

Slider

NA

Single checkbox

NA

Checkbox group

Grid table cell

Tab 

Call To Action with short text



(warning) on Error, button is disabled

Call To Action with mixed errors

(warning) error takes priority


Call to action with long text.

(warning) Pop-up size might need to expand in height


 *  Unlike "field validation error" the warning version can appear on top of controls that does not have a text field, since a warning can appear when there is a conflict between 2 controls. 

Text position:

  • Text position can be either near the CTA (right-aligned) or at the beginning of the row (left-aligned) according to size and available width
    See examples:

    Image RemovedImage Added


Content

  • Descriptive text on the actions row (e.g. Submit)

  • If only 1 field didn't pass validation, the text near the CTA should be the same as the tooltip 

  • If both Warning and Error are found, the text should address the Error

  • If multiple fields didn't pass validation of the same type, the text near the CTA should be "X warnings found" <<TBD with Docs.>>

  • In cases where the text is very long, the section should get a scroll
    For example:

  • In general

    • Specify why field info was not accepted - your validation messages should tell users exactly why their information got rejected or may have some risk

    • If the values entered may impact some other part of the system, briefly explain what may be impacted

  • Keep it short!

...

  • 2 options for the content of the error message:

    • Generic 
      The content of the message is written in advance and there is no need to refer to the specific text that the user typed, for EX: "not a valid zip code" 

    • Input based ( (warning) Preferred option where applicable)
      The content of the message can dynamically change based on the input of the user, use it to clarify to the user where the error is coming from.
      Some examples:

      •  Invalid input → zip code cannot contain the special character: "%"

      • You cannot book this flight, please select another destination or date → Direct flights to Dublin are only available in August. Please select another destination or date 

  • For complicated fields, an example in the text of the tooltip can help

  • Try to avoid negative words

    • (e.g. "Password does not meet requirements" or "Invalid Password" → could be turned into→ "Password must contain 8 alphanumeric characters")

  •        

Accessibility compliance

...