| Milestone 1a finding ID | M1a-042 |
|---|---|
| Backlog priority | High |
| Severity — carried from Milestone 1a | Serious |
| Implementation effort | Medium |
| Target milestone(s) | MS2b — Core Forms and Validation; MS3b — Backend Template Build |
| WCAG 2.2 success criterion | 1.3.1 Info and Relationships; 1.3.2 Meaningful Sequence; 3.3.1 Error Identification; 3.3.2 Labels or Instructions; 3.3.4 Error Prevention (Legal, Financial, Data) |
| Responsibility tag(s) from report | Development |
| Affected Joomla area/component | Joomla Installer — administrator password fields and requirements — Milestone 1a finding #42 |
| Affected user journey(s) | 13 — Install Joomla |
When setting the administrator password during Joomla installation, the password must contain at least 12 characters.
The requirement is not associated with the password field in a way that assistive technology can expose while the user is creating or entering the password.
If the password is shorter than 12 characters, assistive-technology users may receive only “This value is not valid.” An <output> element may announce “Password doesn’t meet the site’s requirements,” but neither message identifies the 12-character requirement.
The report recommends associating the requirement “Enter at least 12 characters” with the password field using aria-describedby, pointing to the message's id. It also suggests considering autocomplete="new-password".
Screen-reader users may not learn that the administrator password must contain at least 12 characters before or while entering it.
They may enter a shorter password, submit the form, and receive a generic error that does not explain how to correct it. They may need to experiment repeatedly to discover the requirement.
This creates a significant barrier during installation, because the administrator password is required to complete setup and cannot be recovered through the normal installation flow.
The issue affects the accuracy and completeness of error identification, as well as the availability of instructions before submission.
Associate the password requirement and field-specific validation with each password field
aria-describedbyid and reference that id from the relevant field<output> status message identifies the unmet requirement rather than only stating that the password does not meet site requirementsautocomplete="new-password" for password-creation fields where appropriatetype, id, aria-describedby, autocomplete, and associated <label>id and textaria-describedby<output> element and record its text and relationship to the field6.2
Each administrator password field in the Joomla Installer has its minimum-length requirement programmatically associated with it.
Assistive-technology users can learn that the password must contain at least 12 characters before or while entering it.
If validation fails, the error identifies the affected field and explains the unmet requirement, including the minimum character count.
The 12-character requirement is not associated with the password fields in a way that assistive technology can convey during password creation or entry.
When the password is too short, users may receive only “This value is not valid.” The <output> element announces only “Password doesn’t meet the site’s requirements.”
Neither message identifies the 12-character requirement.
The current Joomla 6.2 installation flow needs to be checked to establish whether the issue persists.
Desktop web
Chrome, Firefox, Edge, Safari
VoiceOver, JAWS, NVDA
The browser and assistive-technology entries above are carried forward from the original issue and do not represent a new verification of every combination against Joomla 6.2.
Development is the responsibility tag in the original report.
The report's suggested aria-describedby approach and autocomplete="new-password" are recommendations, not the only possible implementation. Verify the chosen approach with assistive technology.
The issue concerns the Joomla Installer's administrator password fields. Do not assume that password fields elsewhere in Joomla have the same implementation or the same failure.
MS2b is proposed for the shared password-field component, with MS3b covering the documented Installer integration.
| Labels |
Added:
a11y
a11y-audit-backlog
a11y-priority-serious (High)
|
||
| Labels |
Added:
No Code Attached Yet
|
||
| Title |
|
||||||
| Labels |
Added:
a11y-ms1b-quickwins
|
||