Technique ARIA18:Using aria-alertdialog to Identify Errors

Description

The purpose of this technique is to alert people that an input error has occurred. Using role="alertdialog" creates a notification. This notification should be modal with the following characteristics:

• aria-label or aria-labelledby attribute gives the alertdialog an accessible name.
• The alertdialog contains at least one focusable element, and the focus should move to that element when the alertdialog opens.
• The tab order is constrained within the alertdialog whilst it is open.
• When the alertdialog is dismissed, the focus moves back to the position it had before the alertdialog opened, if possible.

Note that the alertdialog should not be present in a way that it will be accessed by assistive technology until it is needed. One way to do this is not to include it in the static HTML and instead to insert it into the DOM via script when the error condition is triggered. The insertion would correspond to the following HTML sample.

Examples

<div role="alertdialog" aria-labelledby="alertHeading">
  <h1 id="alertHeading">Error</h1>
  <p>Employee's Birth Date is after their hire date.
   Please verify the birth date and hire date.</p>
  <button>Save and Continue</button>
  <button>Return to page and correct error</button>
</div>

Related Resources

No endorsement implied.

• WAI-ARIA Authoring Practices Guide

Tests