Skip to content

fix(settings): correct heading order in account management sidebar#61505

Merged
pringelmann merged 3 commits into
masterfrom
fix/settings-group-nav-heading-order
Jun 23, 2026
Merged

fix(settings): correct heading order in account management sidebar#61505
pringelmann merged 3 commits into
masterfrom
fix/settings-group-nav-heading-order

Conversation

@pringelmann

Copy link
Copy Markdown
Contributor

Summary

The account management page renders the sidebar "Groups" caption as an <h2>. The navigation comes before the main content in the DOM, so that <h2> lands ahead of the page's <h1> (the view title, e.g. "Account group: X"), and the heading outline reads h2 then h1. That fails WCAG 1.3.1 / BITV 9.1.3.1a (headings out of order).

This moves the "Groups" caption inside the NcAppNavigationList and drops is-heading, so it's a list caption instead of a heading. The page's only heading is then the content <h1>, a single correctly-nested outline. The group list keeps its visible label, it's just no longer exposed as a heading.

Screenshots from HeadingsMap:

Before After
image image

TODO

  • Backports to stable34 / stable33 / stable32 after merge

Checklist

  • Code is properly formatted
  • Sign-off message is added to all commits
  • Tests (unit, integration, api and/or acceptance) are included
  • Screenshots before/after for front-end changes (heading outline above; rendering is unchanged)
  • Documentation (manuals or wiki) has been updated or is not required
  • Backports requested where applicable (ex: critical bugfixes)
  • Labels added where applicable (bug, accessibility, 3. to review, feature: settings)
  • Milestone added for target branch/version

Signed-off-by: Peter Ringelmann <peter.ringelmann@nextcloud.com>
:disabled="loadingAddGroup"
:aria-label="loadingAddGroup ? t('settings', 'Creating group…') : t('settings', 'Create group')"
force-menu
is-heading

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

key change: is-heading dropped

@pringelmann pringelmann self-assigned this Jun 22, 2026
@pringelmann pringelmann added this to the Nextcloud 35 milestone Jun 22, 2026
@pringelmann pringelmann marked this pull request as ready for review June 22, 2026 14:43
@pringelmann pringelmann requested a review from a team as a code owner June 22, 2026 14:43
@pringelmann pringelmann requested review from nfebe, sorbaugh and susnux and removed request for a team June 22, 2026 14:43
@pringelmann pringelmann added the 3. to review Waiting for reviews label Jun 22, 2026
@pringelmann

Copy link
Copy Markdown
Contributor Author

/backport to stable33

@pringelmann

Copy link
Copy Markdown
Contributor Author

/backport to stable34

@pringelmann

Copy link
Copy Markdown
Contributor Author

/backport to stable32

Comment thread apps/settings/src/components/AppNavigationGroupList.vue
Signed-off-by: Peter Ringelmann <peter.ringelmann@nextcloud.com>
@pringelmann pringelmann force-pushed the fix/settings-group-nav-heading-order branch from b6b5b47 to 122c253 Compare June 22, 2026 16:13
@pringelmann pringelmann requested review from artonge and susnux June 22, 2026 16:15
@pringelmann pringelmann requested a review from skjnldsv June 23, 2026 04:41

@cristianscheid cristianscheid left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

Signed-off-by: Peter Ringelmann <peter.ringelmann@nextcloud.com>
@pringelmann pringelmann merged commit b5fb529 into master Jun 23, 2026
157 of 164 checks passed
@pringelmann pringelmann deleted the fix/settings-group-nav-heading-order branch June 23, 2026 15:07
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.

3 participants