Form Instructions and Help Text

Visual Example


Acceptance Criteria

As a screen reader and keyboard only user I should:

  • be provided with a form label

  • be able to use the TAB key on the keyboard to access the form control

  • be able to access important form instructions and help text

As a screen reader user I should:

  • be able to explicitly associate the text label with the form control

When the form field has keyboard focus: 

  • the screen reader should announce the form label

  • the screen reader should announce the form instructions


Markup and Code

Use the “aria-describedby” attribute to associate the form instructions with the form control.

<form> <div> <label for="phone-number">Phone Number</label> <input id="phone-number" type="text" aria-describedby="phoneinstructions"> <p id="phoneinstructions">Enter your 10 digit phone number including area code.</p> </div> </form>

View markup on github