Steps to reproduce the issue
| Milestone 1a finding ID |
M1a-023 |
| Backlog priority |
Medium |
| Severity — carried from Milestone 1a |
Moderate |
| Implementation effort |
Low |
| Target milestone(s) |
MS7a — Core Workflow Components; MS7b — MFA and Content Workflows |
| WCAG 2.2 success criterion |
1.3.2 Meaningful Sequence; 2.4.3 Focus Order |
| Responsibility tag(s) from report |
Development |
| Affected Joomla area/component |
Save & Close split button — dropdown order and accessible name — Milestone 1a finding #23 |
| Affected user journey(s) |
05 — MFA Setup — Method / Methods Views; 09 — Backend Edit Form Pattern |
Audit finding
The Save & Close control can include a dropdown toggle, displayed as an arrow to the right of the primary button.
Although the dropdown toggle appears after the primary button visually, it comes first in the keyboard focus order.
The report records the screen-reader announcement as: "Save, button; Toggle Dropdown, menu pop up, button; Save and Close, button"
This sequence presents the secondary control before the primary Save & Close button. It also does not make clear that the dropdown contains alternatives relating to saving and closing.
The report additionally identifies “Toggle Dropdown” as a non-descriptive accessible name, particularly because the control’s role already conveys that it opens a dropdown.
The report recommends matching the code order to the visual order and using a more descriptive accessible name, suggesting “Save options” or similar.
User impact
Keyboard users encounter the dropdown toggle before the primary Save & Close button. They may activate the toggle expecting it to control the preceding “Save” button, then encounter the primary button afterwards.
Screen-reader users hear “Toggle Dropdown” without enough context to know which button’s options it opens. They may need to move through the group more than once to understand its purpose.
The confusing sequence can make saving, closing, or choosing an alternative save action slower and more error-prone, particularly for people using keyboard-only interaction or a screen reader.
Remediation plan
Align the programmatic order and accessible naming of the split button with its visual meaning
- Ensure that the primary Save & Close button receives focus before its dropdown toggle
- Match the DOM order to the visual order unless a deliberate, accessible reading order requires otherwise
- Replace “Toggle Dropdown” with an accessible name that identifies the control whose options it opens
- Consider “Save options”, “Save and Close options”, or equivalent wording appropriate to the button group
- Ensure the accessible name does not duplicate unnecessary role information
- Preserve the visual relationship between the primary button and its dropdown toggle
- Ensure that activating the toggle opens the options associated with Save & Close
- Ensure that the dropdown options remain programmatically associated with the toggle where applicable
- Preserve keyboard operation, visible focus, and a logical focus return after closing the menu
- Apply the corrected pattern to the shared button-group component
- Verify the MFA and Articles implementations separately
- Do not rely on visual position alone to convey the relationship between the primary button and its toggle
Preconditions
- Use Joomla 6.2 with the Atum administrator template
- Sign in with an account permitted to access the relevant views
- For the Articles example, use a test article that displays the Save & Close split button
- For the MFA example, use a view that displays the same split-button pattern
- Record the exact Joomla build, browser name and version, operating system, viewport dimensions, and browser zoom
- Record the screen reader and browser combination if testing announcements
- Start at 100% browser zoom
- Use a disposable test article and do not save unintended changes
Steps to reproduce — Articles edit form
- Open the Joomla administrator interface at the site's base URL followed by
/administrator/
- Open Content → Articles
- Open an existing test article for editing
- Alternatively, navigate to
/administrator/index.php?option=com_content&view=article&layout=edit&id=11 on a test installation containing that article
- Record the article ID and editor configuration used
- Locate the Save & Close split button
- Record the visual order of the primary button and dropdown toggle
- Move keyboard focus to the start of the button group
- Press Tab repeatedly and record the order in which controls receive focus
- Confirm whether the dropdown toggle receives focus before the primary Save & Close button
- Inspect the button group's DOM order using Developer Tools
- Record whether the DOM order matches the visual order
- Record the dropdown toggle's accessible name and role
- Activate the toggle and record the options presented
- Confirm whether the options relate to Save & Close
- Close the menu without selecting an option
- Capture the visual order, focus order, DOM order, accessible name, and menu contents
- If using a screen reader, record the announcement for each control in sequence
Steps to reproduce — MFA view
- Open Users → Manage Multi-factor Authentication
- Record the navigation labels if they differ in the tested build
- Locate the view or method detail page that displays the Save & Close split-button pattern
- Repeat the visual-order, focus-order, DOM-order, accessible-name, and menu-content checks
- Record any differences from the Articles example
- Capture evidence for each affected MFA view separately
- Do not save or delete an authentication method during verification
Screen-reader verification
- Use a screen reader with the browser combination being tested
- Navigate to the button group using the keyboard
- Record the announcement of the primary button
- Record the announcement of the dropdown toggle
- Record the announcement of the primary button again if the reported sequence occurs
- Activate the dropdown toggle and record the menu announcement
- Close the menu and record the focus behaviour
- Repeat with at least one additional screen reader if available
- Record the screen-reader name, version, browser, and operating system
- Do not treat a visual-order fix alone as sufficient if the announced sequence remains confusing
Verification after remediation
- Open an affected view containing the Save & Close split button
- Confirm that the primary button receives focus before its dropdown toggle
- Confirm that the DOM order matches the visual order
- Confirm that the toggle's accessible name identifies the options it opens
- Activate the toggle and confirm that the menu contains the expected save-related options
- Close the menu and confirm that focus returns predictably
- Repeat in the MFA and Articles contexts
- Confirm that keyboard operation and visible focus remain intact
- Record the final accessible name, focus order, and menu behaviour
Version
6.2
Expected result
The primary Save & Close button receives keyboard focus before its dropdown toggle.
The DOM order matches the visual order of the button group.
The dropdown toggle has an accessible name that identifies the options it opens, such as “Save options” or equivalent wording appropriate to the control.
Screen-reader users can understand that the dropdown contains alternatives relating to Save & Close.
Actual result
The dropdown toggle receives keyboard focus before the primary Save & Close button, even though it appears after that button visually.
The report records the screen-reader announcement as “Save, button; Toggle Dropdown, menu pop up, button; Save and Close, button.”
The accessible name “Toggle Dropdown” does not identify which button’s options the control opens.
The current Joomla 6.2 build needs to be checked to establish whether the issue persists and which views use the affected pattern.
What device were you using? (eg, phone, laptop)
Desktop web
What web browser were you using? (eg, Chrome, Safari)
Chrome, Firefox, Edge, Safari
Assistive Technology?
VoiceOver, JAWS, NVDA
Additional Comments
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 “Save options” label is an example, not a required final string. Use wording that accurately describes the options opened by the toggle.
This issue concerns the sequence and naming of an existing split button. It does not require changing which save actions are available.
MS7a is proposed for the shared button-group component, with MS7b covering the documented MFA and Articles integrations.