Skip to content
PatternFly logo

Helper text

Helper text is an on-screen field guideline that helps provide context regarding field inputs.

Demos

Static variant with static text

In this demo, the static variant of the helper text item component (the default) is used, and the text itself will always be visible to users and will never change.

The aria-describedby attribute is passed into the text input component and is linked to the id of the helper text component. This allows assistive technologies to notify users of the helper text content when the input receives focus, which can be helpful if a user navigates away from and then back to the input.

Note that this demo does not validate the text input component. When it would need to be validated, there are other steps that would need to be taken to make it accessible, such as passing in aria-invalid and aria-live attributes to the appropriate components.

Enter your middle name or your middle initial

Static variant with dynamic text

In this demo, the static variant of the helper text item component (the default) is used with the hasIcon prop passed in when there is an error, and the text itself dynamically updates based on the input value. When the input has a value of johndoe, an error is rendered to simulate a username already being taken, while an empty input renders other helper text. When the input is valid, no helper text is rendered.

The aria-describedby attribute is passed into the text input component and is linked to the id of the helper text component. Similar to the static variant with static text demo, this allows assistive technologies to notify users of the helper text content when the navigating to the input.

An aria-live region is passed into the helper text component, which allows assistive technologies to announce to users when any dynamic content within it updates, such as when the text content changes or gets rendered. Without this attribute, a user would have to navigate out of and back into the input field multiple times to check the status of their input.

The aria-invalid attribute is also passed into the text input, which allows assistive technologies to notify users that an input is invalid. When this attribute is true, it's important that users are notified of what is causing the input to be invalid; in this case, aria-describedby and aria-live help accomplish this.

Please enter a username

Dynamic variant with static text

In this demo, the helper text item components have the isDynamic prop passed in. While the text content of the components is static, the icons and styling will change as the validation of the input changes.

The aria-describedby attribute is passed into the text input component and is linked to the id attribute of a helper text item that results in an invalid input. This will allow assistive technologies to only be notified of any outstanding criteria that has not been met when the input receives focus.

Similar to the static variant with dynamic text example, the aria-invalid attribute is passed in, allowing assistive technologies to announce to users when at least 1 item is causing the input to be invalid.

  • Must be at least 5 characters in length : indeterminate status;
  • Must include at least 1 number : indeterminate status;

View source on GitHub