Using the aria-required attribute

Description

This technique demonstrates how to use the aria-required attribute.

The aria-required attribute is used to indicate that user input is required on an element before a form can be submitted. This attribute can be used with any typical HTML form element; it is not limited to elements that have an ARIA role assigned.

HTML5 now has the required attribute, but aria-required is still useful for user agents that do not yet support HTML5.

Value

true or false (Default: false)

Possible effects on user agents and assistive technology 

Screen readers should announce the field as required.

Note that this attribute will not automatically change the presentation of the field.

Note: Opinons may differ on how assistive technology should handle this technique. The information provided above is one of those opinions and therefore not normative.

Examples

Example 1: A simple form

 

 <form action="post">
     <label for="firstName">First name:</label>
     <input id="firstName" type="text" aria-required="true" />
     <br/>
     <label for="lastName">Last name:</label>
     <input id="lastName" type="text" aria-required="true" />
     <br/>
     <label for="streetAddress">Street address:</label>
     <input id="streetAddress" type="text" />
 </form>

Working Examples:

Tooltip example (includes the use of the aria-required attribute)

Notes 

Used in ARIA roles

  • Combobox
  • Gridcell
  • Listbox
  • Radiogroup
  • Spinbutton
  • Textbox
  • Tree

Compatibility

TBD: Add support information for common UA and AT product combinations

Additional resources

Document Tags and Contributors

Contributors to this page: Sheppy, anastasia
Last updated by: Sheppy,