Skip to content

fix: add accessible names to v8 docsite navigation and CommandBar examples - #40

Draft
mainframev wants to merge 29 commits into
masterfrom
fix/v8-docsite-nav-labels
Draft

mainframev wants to merge 29 commits into
masterfrom
fix/v8-docsite-nav-labels

Conversation

@mainframev

Copy link
Copy Markdown
Owner

Previous Behavior

On the v8 docsite (developer.microsoft.com/fluentui), several navigation and menubar regions had no accessible name, so screen reader users heard several identical "navigation" or "menu bar" landmarks and could not tell them apart:

  • the left page nav on every control page (<nav role="navigation"> in public-docsite)
  • the Nav "FocusZone" example
  • 4 of 5 CommandBar examples (ButtonAs, CommandBarButtonAs, SplitDisabled, Lazy)

New Behavior

  • The docsite left nav is named after the current section (for example "Controls"), falling back to "Pages".
  • The Nav and CommandBar examples set ariaLabel, following the "Nav example with …" naming the other examples already use.

No component changes: Nav, CommandBar and OverflowSet already support an accessible name. Both changed packages are private, so there is no change file.

Screenshots

Unnamed regions are outlined with a dashed red line, named ones with a solid green line. Before is the live docsite, after is the local docsite.

Before After
Nav before nav after nav
CommandBar before commandbar after commandbar

The local docsite also shows an unnamed top nav (TopNav in @fluentui/react-docsite-components). Production replaces it with the Microsoft site header, which is already labeled, so it is out of scope here.

Related Issue(s)

  • ADO 36762

bigbadcapers and others added 29 commits October 21, 2026 21:48
…0.8 (microsoft#36883)

Co-authored-by: Carlos Perez (M365) <caperez+microsoft@microsoft.com>
Co-authored-by: Paul Mardling <paulmardling@microsoft.com>
)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 6fa18c13-00c6-4e5e-a8ec-5c67bd4d2948
…crosoft#36969)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…soft#36752)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Martin Hochel <martinhochel@microsoft.com>
Copilot-Session: ed39bb7d-827b-40e9-bc3b-3bf27e334d85
Copilot-Session: 176a875a-00fc-4f92-8657-efeb3a6e62a1
Copilot-Session: 92cc9ccd-6e8f-4638-8c08-b2323aa950a1
Copilot-Session: f94cca35-e6fc-4bee-8616-d5120bec27c4
…o 3.0.5 (microsoft#36924)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
…b-actions-minor-patch group across 1 directory (microsoft#36922)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
…dependencies group across 1 directory (microsoft#36998)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Hotell <1223799+Hotell@users.noreply.github.com>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
…soft#37017)

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Martin Hochel <martinhochel@microsoft.com>
Copilot-Session: b2dea0c5-9693-406d-8e08-38a6334389fb
Co-authored-by: Dmytro Kirpa <dmytrokirpa@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…osoft#36987)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…t#36886)

Co-authored-by: Paul Mardling <paulmardling@microsoft.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…mples

The v8 docsite left page nav and five Nav/CommandBar examples rendered
navigation and menubar regions without an accessible name, so screen
reader users could not tell them apart (ADO 36762).

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants