Skip to content

Document back button accessibility label in .NET MAUI 11#3370

Merged
jfversluis merged 3 commits into
dotnet:mainfrom
davidortinau:daortin/p5-backbutton-accessibility
Jun 12, 2026
Merged

Document back button accessibility label in .NET MAUI 11#3370
jfversluis merged 3 commits into
dotnet:mainfrom
davidortinau:daortin/p5-backbutton-accessibility

Conversation

@davidortinau

Copy link
Copy Markdown
Contributor

Adds documentation for the new accessibility-label APIs that flow to the toolbar back button in .NET MAUI 11:

  • NavigationPage.BackButtonAccessibilityLabel attached property — new "Set the back button accessibility label" subsection in docs/user-interface/pages/navigationpage.md, plus a moniker-gated NOTE in the property overview list.
  • BackButtonBehavior.AccessibilityLabel property — new moniker-gated block in the "Back button behavior" section of docs/fundamentals/shell/navigation.md.

Both additions cross-link to docs/fundamentals/accessibility.md.

Tracks dotnet/maui#35011 and aligns with the .NET 11 Preview 5 release notes (dotnet/core#10433).

Adds documentation for the new accessibility-label APIs that flow
SemanticProperties to the toolbar back button:

- NavigationPage.BackButtonAccessibilityLabel attached property
  (new "Set the back button accessibility label" subsection in
  navigationpage.md, plus a NOTE in the property table).
- BackButtonBehavior.AccessibilityLabel property (Shell, new
  moniker-gated block in shell/navigation.md's "Back button
  behavior" section).

Both additions cross-link to docs/fundamentals/accessibility.md.

Tracks dotnet/maui#35011 and aligns with the .NET 11 Preview 5
release notes published in dotnet/core#10433.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit eecb1d3:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/navigation.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/pages/navigationpage.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Copilot AI review requested due to automatic review settings June 11, 2026 15:19
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 87715f1:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/navigation.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/pages/navigationpage.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the .NET MAUI documentation to describe new .NET MAUI 11 APIs for setting an accessibility label that screen readers announce for the toolbar back button, with cross-links to the Accessibility guidance.

Changes:

  • Adds a .NET MAUI 11 monikered NOTE and a new subsection documenting NavigationPage.BackButtonAccessibilityLabel.
  • Adds a .NET MAUI 11 monikered block documenting BackButtonBehavior.AccessibilityLabel in Shell navigation docs.
  • Updates ms.date metadata on both pages.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 8 comments.

File Description
docs/user-interface/pages/navigationpage.md Adds .NET MAUI 11 monikered guidance and a new subsection for NavigationPage.BackButtonAccessibilityLabel.
docs/fundamentals/shell/navigation.md Adds .NET MAUI 11 monikered guidance for BackButtonBehavior.AccessibilityLabel including a XAML example.

Comment thread docs/user-interface/pages/navigationpage.md Outdated
Comment thread docs/user-interface/pages/navigationpage.md Outdated
Comment thread docs/user-interface/pages/navigationpage.md Outdated
Comment thread docs/user-interface/pages/navigationpage.md Outdated
Comment thread docs/user-interface/pages/navigationpage.md Outdated
Comment thread docs/fundamentals/shell/navigation.md Outdated
Comment thread docs/fundamentals/shell/navigation.md Outdated
Comment thread docs/fundamentals/shell/navigation.md Outdated
Use consistent DocFX moniker spacing and align the explanatory text with the XAML samples.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 1350465:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/navigation.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/pages/navigationpage.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@jfversluis jfversluis merged commit 1afa221 into dotnet:main Jun 12, 2026
7 checks passed
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.

4 participants