Skip to content

chore(ui): improve a11y with live regions and form autocomplete#5802

Merged
gustavosbarreto merged 1 commit intomasterfrom
chore/a11y-live-regions-autocomplete
Feb 12, 2026
Merged

chore(ui): improve a11y with live regions and form autocomplete#5802
gustavosbarreto merged 1 commit intomasterfrom
chore/a11y-live-regions-autocomplete

Conversation

@luannmoreira
Copy link
Member

Description

This PR improves accessibility across the Admin UI and main UI by ensuring
dynamic messages are announced properly by screen readers and by adding
browser autofill hints to common form fields.

What changed

  • Added role and aria-live attributes to alerts and status messages:
    • role="alert" + aria-live="assertive" for errors/warnings.
    • role="status" + aria-live="polite" for informational/status updates.
  • Applied consistently across announcement, SSO, license, dialogs, auth,
    billing, devices, welcome, and other views.
  • Added autocomplete attributes to improve autofill and accessibility for:
    • name, username, email
    • current-password, new-password
    • one-time-code (OTP/MFA flows)
  • Confirm Account: disabled the “Resend Email” button unless a valid
    username query param is present (canResend computed).
  • Updated UI test snapshots to reflect new attributes.

Why

  • Screen readers weren’t reliably announcing dynamic alerts/messages.
    Explicit live regions make those updates perceivable.
  • Autocomplete hints improve usability, reduce input errors, and help assistive
    technologies.
  • Prevents resend action when required context (username) is missing.

Testing

  • Existing unit/component tests updated via snapshots.
  • Manually verify:
    • Error/warning messages are announced immediately.
    • Status/info messages are announced politely.
    • Autofill works for login/signup/setup/MFA and billing forms.
    • “Resend Email” is disabled when username is not in the URL query.

Add role and aria-live to alerts/status messages so screen readers
announce updates appropriately (assertive for errors/warnings, polite for
status/info).

Add autocomplete hints for common fields (name, username, email,
current/new password, one-time-code) to improve UX and accessibility.

Disable "Resend Email" in confirm account view unless a valid username is
present in the query string.

Update component snapshots to match new attributes.
@luannmoreira luannmoreira force-pushed the chore/a11y-live-regions-autocomplete branch from 0300678 to b9b3d0f Compare February 12, 2026 12:34
@gustavosbarreto gustavosbarreto merged commit 9be0b50 into master Feb 12, 2026
9 checks passed
@gustavosbarreto gustavosbarreto deleted the chore/a11y-live-regions-autocomplete branch February 12, 2026 13:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants