Password

A label is required for password fields and defaults to “Password”. The included label can be hidden if there is another adjacent text element acting as the label.

The password value is submitted with the form. It is obfuscated with dots by default.

There are two layouts available for password fields, stacked and floating. Stacked labels are above the field and floating labels are inside the field. A floating label animates upward on focus to make room for the value.

Helper text is placed below the field and informs the user of any requirements or disclaimers. Helper text can be shown persistently or on focus.

When a field fails validation, the helper text produces an error message to help users successfully fulfill the password requirements. Error messages are concise and direct, and replace any previously visible helper text. An error icon is prepended to the helper text to improve discoverability.

There are two sizes available: 48px and 40px. These sizes match available button sizes in case they’re inline together. Avoid mixing different sizes in a single form.

Longer passwords flow beyond the visible container. While focused, the value overflows to the left to keep the cursor in view as characters are entered. When the field loses focus, the value shifts to the beginning and overflows to the right. Focusing on the field again returns to the end of the value.

The privacy icon toggles between showing and hiding the characters entered to aid in situations where the password needs to be reviewed.

The icon conveys what will happen when interacted with, not the current state, so a concealed value has the show icon and a revealed value has the hide icon.

Password fields span the full width of the screen on smaller screens.