Daily Accessibility ReviewModal Dialogs Missing Accessible Name (aria-label/aria-labelledby)

[github-actions[bot]]

Summary

The AppModal.vue component renders a role="dialog" element without an accessible name (aria-label or aria-labelledby). This means screen reader users are not informed of the dialog's purpose when focus moves into it.

WCAG 2.2 Reference

• SC 4.1.2 – Name, Role, Value (Level A): For all user interface components, the name and role can be programmatically determined. Every dialog (role="dialog") must have an accessible name provided via aria-label or aria-labelledby so that assistive technologies can announce the dialog's purpose to users.
• ARIA Authoring Practices: The ARIA spec states that a dialog element must have an accessible name.

Affected File

shell/components/AppModal.vue (lines 198–210):

<div
  v-bind="$attrs"
  id="modal-container-element"
  ref="modalRef"
  :class="customClass"
  class="modal-container"
  :style="modalStyles"
  role="dialog"
  aria-modal="true"
  `@click`.stop
>
  <slot><!--Empty content--></slot>
</div>

Note: the <div> has role="dialog" and aria-modal="true", but no aria-label or aria-labelledby.

Impact

When a modal opens, screen readers announce "dialog" without any context about what the dialog contains or its purpose. Users relying on assistive technologies cannot determine the purpose of the modal.

Recommended Fix

1. Add a prop name/title to AppModal for the accessible name, and bind it:

   <div
     role="dialog"
     aria-modal="true"
     :aria-label="modalTitle || undefined"
     :aria-labelledby="modalTitleId || undefined"
   >

2. Alternatively, ensure all consumers of AppModal pass an aria-label or aria-labelledby via v-bind="$attrs", and document this as a usage requirement.
3. The Dialog.vue, PromptRemove.vue, ModalManager.vue, and ModalWithCard.vue components — all of which wrap AppModal — should also be reviewed to ensure they supply an accessible name.

Generated by Daily Accessibility Review · ● 2M · ◷

• expires on Jun 3, 2026, 8:36 AM UTC