Skip to content

Document .NET 11 badge support for Shell tabs and ToolbarItems - #3359

Open
jfversluis with Copilot wants to merge 3 commits into
mainfrom
copilot/update-dotnet-11-docs-badges
Open

Document .NET 11 badge support for Shell tabs and ToolbarItems#3359
jfversluis with Copilot wants to merge 3 commits into
mainfrom
copilot/update-dotnet-11-docs-badges

Conversation

Copilot AI commented May 24, 2026 •
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Contributor

.NET MAUI 11 Preview 4 adds badge support for Shell tabs and ToolbarItem controls. This updates the docs to surface the new capability in both feature documentation and What's New content.

  • What's New

    • Added a .NET 11 Preview 4 entry for Shell tab and toolbar item badges.
    • Linked to the detailed Shell tab and ToolbarItem badge docs.
    • Referenced the upstream MAUI implementation PRs.

  • Feature docs

    • Added hidden screenshot placeholders near the Shell tab and ToolbarItem badge examples for future image assets.

Example badge usage:

<ToolbarItem Text="Inbox"
             IconImageSource="inbox.png"
             BadgeText="3"
             BadgeColor="Red"
             BadgeTextColor="White" />

Internal previews

File Preview link
docs/fundamentals/shell/tabs.md docs/fundamentals/shell/tabs
docs/user-interface/toolbaritem.md docs/user-interface/toolbaritem
docs/whats-new/dotnet-11.md docs/whats-new/dotnet-11

Copilot AI linked an issue May 24, 2026 that may be closed by this pull request
.NET 11 preview 4 Shell tab and ToolBarIcon badge support #3358
Open
@learn-build-service-prod

learn-build-service-prod Bot commented May 24, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 6360483:

✅ Validation status: passed

For more details, please refer to the build report.

@jfversluis
.NET 11: document badge support in whats new
9465cc1 
Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/fd7b4e65-6909-4e78-a025-d8f31138f6c2

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>
Copilot AI changed the title [WIP] Update .NET 11 documentation for Shell tab and ToolBarIcon badge support Document .NET 11 badge support for Shell tabs and ToolbarItems May 24, 2026
@learn-build-service-prod

learn-build-service-prod Bot commented May 24, 2026

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 requested a review from jfversluis May 24, 2026 14:00
@learn-build-service-prod

learn-build-service-prod Bot commented May 24, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 9465cc1:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/tabs.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/toolbaritem.md ✅Succeeded View (>=net-maui-8.0)
docs/whats-new/dotnet-11.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@jfversluis
jfversluis marked this pull request as ready for review August 11, 2026 18:04
@jfversluis
jfversluis requested a review from a team as a code owner August 11, 2026 18:04
@jfversluis
jfversluis requested review from davidortinau and a lite review from Copilot August 11, 2026 18:04
Copilot AI reviewed Aug 11, 2026
View reviewed changes

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 docs to document new .NET 11 Preview 4 badge support for Shell tabs and ToolbarItem, including a corresponding entry in the .NET 11 “What’s New” page and placeholder markers for future screenshots.

Changes:

  • Added a .NET 11 Preview 4 “What’s New” entry describing badge support and linking to the detailed feature docs.
  • Added screenshot placeholder comments near the new badge examples in Shell tabs and ToolbarItem documentation.
  • Updated ms.date on the .NET 11 “What’s New” page.
Show a summary per file
File Description
docs/whats-new/dotnet-11.md Adds a .NET 11 Preview 4 entry for Shell tab and ToolbarItem badges and updates page date.
docs/user-interface/toolbaritem.md Adds a screenshot placeholder comment near the ToolbarItem badge example.
docs/fundamentals/shell/tabs.md Adds a screenshot placeholder comment near the Shell tab badge example.

Review details

Tip

Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

  • Files reviewed: 3/3 changed files
  • Comments generated: 1
  • Review effort level: Lite

Comment thread docs/whats-new/dotnet-11.md

:::moniker range=">=net-maui-11.0"

Starting in .NET 11 Preview 4, Shell bottom tabs and <xref:Microsoft.Maui.Controls.ToolbarItem> objects support badges for surfacing counts or status indicators. Set `BadgeText` to a non-empty value to show a text or count badge, set it to an empty string to show a dot indicator, or set it to `null` to hide the badge. You can customize badge colors with `BadgeColor` and `BadgeTextColor`.
@jfversluis

jfversluis commented Aug 11, 2026

Copy link
Copy Markdown
Member

@copilot resolve the merge conflicts on this branch.

@jfversluis
Merge remote-tracking branch 'origin/main' into copilot/update-dotnet…
2ef5722 
…-11-docs-badges

# Conflicts:
#	docs/whats-new/dotnet-11.md

Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

Copilot AI commented Aug 11, 2026

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts on this branch.

Resolved and merged the current main into this branch in 2ef5722.

@learn-build-service-prod

learn-build-service-prod Bot commented Aug 11, 2026

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

learn-build-service-prod Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 2ef5722:

💡 Validation status: suggestions

File Status Preview URL Details
docs/whats-new/dotnet-11.md 💡Suggestion View (>=net-maui-8.0) Details
docs/fundamentals/shell/tabs.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/toolbaritem.md ✅Succeeded View (>=net-maui-8.0)

docs/whats-new/dotnet-11.md

  • Line 221, Column 342: [Suggestion: learn-site-link-broken - See documentation] Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link.
  • Line 247, Column 651: [Suggestion: learn-site-link-broken - See documentation] Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Copilot AI requested a review from jfversluis August 11, 2026 19:17
@jfversluis jfversluis closed this Aug 11, 2026
@jfversluis jfversluis reopened this Aug 11, 2026
@learn-build-service-prod

learn-build-service-prod Bot commented Aug 11, 2026

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

learn-build-service-prod Bot commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 2ef5722:

💡 Validation status: suggestions

File Status Preview URL Details
docs/whats-new/dotnet-11.md 💡Suggestion View (>=net-maui-8.0) Details
docs/fundamentals/shell/tabs.md ✅Succeeded View (>=net-maui-8.0)
docs/user-interface/toolbaritem.md ✅Succeeded View (>=net-maui-8.0)

docs/whats-new/dotnet-11.md

  • Line 221, Column 342: [Suggestion: learn-site-link-broken - See documentation] Link '/samples/dotnet/maui-samples/navigation-shell-route-templates' points to a learn site page that doesn't exist. Check the path or URL and update the link.
  • Line 247, Column 651: [Suggestion: learn-site-link-broken - See documentation] Link '/samples/dotnet/maui-samples/platformintegration-passkeys' points to a learn site page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@github-actions github-actions Bot mentioned this pull request Aug 12, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot
Copilot review effort
Applies to this pull request for everyone.Learn more about Copilot code review.
Copilot left review comments
@davidortinau davidortinau Awaiting requested review from davidortinau
+1 more reviewer
@jfversluis jfversluis jfversluis approved these changes
Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

@jfversluis jfversluis

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

.NET 11 preview 4 Shell tab and ToolBarIcon badge support

3 participants

@jfversluis