modal-exit-trap

Description

Ensure that users can close all modals on a website using a keyboard-accessible method.

You can configure the tabindex attribute to a close button to ensure that this rule is followed.

Example

Consider the following example.

Although this modal has a close button, keyboard users can’t access it as a user will have to use a pointing device to click the close button. So, this code violates the modal-exit-trap rule.

In contrast, the following example defines tabindex="0" on the close button.

With tabindex="0" defined on the close button, keyboard users can easily close the modal. This improves the accessibility and user experience of the modal.

How to fix?

Follow these steps to fix the modal-exit-trap rule if it gets flagged:

• Identify any modals used on your webpage.
• Check if it has a close button and if the close button is navigatable using a keyboard.
• If not, create a close button and use tabindex="0" to make it accessible using a keyboard.

Reference

• WCAG 2.1.2: No Keyboard Trap (Level A)
• Technique G21
• modal-closure-with-esc