Document Shell and ToolbarItem badges (.NET 11)#3333
Merged
Conversation
In .NET MAUI 11 (Preview 4), BaseShellItem (Tab, ShellContent, FlyoutItem) and ToolbarItem gain BadgeText, BadgeColor, and BadgeTextColor bindable properties for displaying badges on navigation surfaces. - docs/fundamentals/shell/tabs.md: new Tab badges section with platform notes for Android (BadgeDrawable), iOS/MacCatalyst (UITabBarItem.BadgeValue), and Windows (InfoBadge). - docs/fundamentals/shell/flyout.md: new FlyoutItem badges section cross-linking to the tabs platform notes. - docs/user-interface/toolbaritem.md: new Display a badge on a ToolbarItem section with toolbar-specific platform notes (iOS 26+ UIBarButtonItem.Badge requirement, primary-only). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
|
Learn Build status updates of commit 2c0ae53: ✅ Validation status: passed
For more details, please refer to the build report. |
Contributor
PoliCheck Scan ReportThe 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 foundMore information about PoliCheckInformation: PoliCheck | Severity Guidance | Term |
This was referenced May 13, 2026
jfversluis
approved these changes
May 15, 2026
jfversluis
added a commit
that referenced
this pull request
May 15, 2026
* Bump actions/upload-artifact from 7.0.0 to 7.0.1 (#3335) Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 7.0.0 to 7.0.1. - [Release notes](https://github.com/actions/upload-artifact/releases) - [Commits](actions/upload-artifact@bbbca2d...043fb46) --- updated-dependencies: - dependency-name: actions/upload-artifact dependency-version: 7.0.1 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * What's new (.NET 11 Preview 4): document new features (#3329) * What's new (.NET 11 Preview 4): document new features Add .NET 11 Preview 4 entries to the What's new page: - CoreCLR is the default runtime on all .NET MAUI platforms - x:Code directive for inline C# in XAML - Compiled bindings inside DataTemplates (regression fix + diagnostics) - Material 3 styling for Android ImageButton, DatePicker, Entry, Slider - MonochromeFile support for Android adaptive icons - dotnet watch for Android - dotnet watch for iOS (incl. MtouchLink=None known issue) - Xcode 26.4 Stable, HTTP digest auth in NSUrlSessionHandler, CoreCLR default on Apple platforms Also adds the Preview 4 release notes link and bumps ms.date. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * What's new (.NET 11 Preview 4): add media assets Add the Material 3 controls screenshot and the dotnet watch GIFs referenced from docs/whats-new/dotnet-11.md. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Bump actions/download-artifact from 8.0.0 to 8.0.1 (#3338) Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 8.0.0 to 8.0.1. - [Release notes](https://github.com/actions/download-artifact/releases) - [Commits](actions/download-artifact@70fc10c...3e5f45b) --- updated-dependencies: - dependency-name: actions/download-artifact dependency-version: 8.0.1 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Bump github/gh-aw from 0.53.5 to 0.73.0 (#3337) Bumps [github/gh-aw](https://github.com/github/gh-aw) from 0.53.5 to 0.73.0. - [Release notes](https://github.com/github/gh-aw/releases) - [Changelog](https://github.com/github/gh-aw/blob/main/CHANGELOG.md) - [Commits](github/gh-aw@ffb8573...4d44d0e) --- updated-dependencies: - dependency-name: github/gh-aw dependency-version: 0.73.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Bump actions/github-script from 8.0.0 to 9.0.0 (#3336) Bumps [actions/github-script](https://github.com/actions/github-script) from 8.0.0 to 9.0.0. - [Release notes](https://github.com/actions/github-script/releases) - [Commits](actions/github-script@v8...3a2844b) --- updated-dependencies: - dependency-name: actions/github-script dependency-version: 9.0.0 dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> * Document Shell and ToolbarItem badges (.NET 11) (#3333) In .NET MAUI 11 (Preview 4), BaseShellItem (Tab, ShellContent, FlyoutItem) and ToolbarItem gain BadgeText, BadgeColor, and BadgeTextColor bindable properties for displaying badges on navigation surfaces. - docs/fundamentals/shell/tabs.md: new Tab badges section with platform notes for Android (BadgeDrawable), iOS/MacCatalyst (UITabBarItem.BadgeValue), and Windows (InfoBadge). - docs/fundamentals/shell/flyout.md: new FlyoutItem badges section cross-linking to the tabs platform notes. - docs/user-interface/toolbaritem.md: new Display a badge on a ToolbarItem section with toolbar-specific platform notes (iOS 26+ UIBarButtonItem.Badge requirement, primary-only). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Document Editor.ReturnCommand wired to completion (.NET 11) (#3331) In .NET MAUI 11 (Preview 4), Editor.ReturnCommand and ReturnCommandParameter are now invoked from SendCompleted, so a command bound to ReturnCommand fires when the Completed event would be raised. This adds a >=net-maui-11.0 monikered note to the Editor properties summary and a small example after the Completed event sample. Upstream: dotnet/maui#32167 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Document MonochromeFile attribute for Android themed icons (.NET 11) (#3330) Adds a >=net-maui-11.0 monikered subsection to app-icons.md describing the new MonochromeFile attribute on <MauiIcon>, which lets single-project Android adaptive icons use a dedicated glyph for the themed (monochrome) icon layer on Android 13+ instead of reusing the foreground image. Upstream: dotnet/maui#34569 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Document x:Code directive for inline C# in XAML (.NET 11) (#3332) Adds a >=net-maui-11.0 monikered subsection to xamlc.md under XAML Source Generation, covering the new x:Code directive. The directive lets a small block of C# live inline in a XAML file, with the source generator emitting it into the page's partial class. Notes the EnablePreviewFeatures requirement, the x:Class requirement, the root child placement rule, and the MAUIX2015/MAUIX2016 analyzer diagnostics. Upstream: dotnet/maui#34715 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Document Material 3 expansion to ImageButton, Switch, and Shell (.NET 11) (#3334) In .NET MAUI 11 (Preview 4), the Android handlers for ImageButton, Switch, and Shell tab bars adopt Material 3 styling when the UseMaterial3 project flag is enabled. Adds three new monikered subsections to material-design.md under Platform availability, matching the existing per-control pattern. Upstream: - ImageButton: dotnet/maui#33649 - Switch: dotnet/maui#33132 - Shell: dotnet/maui#33427 Screenshots for the new controls can be added in a follow-up. Co-authored-by: Copilot <223556219+Copilot@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: David Ortinau <david.ortinau@microsoft.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
>=net-maui-11.0monikered sections documenting the new badge properties for Shell navigation items andToolbarItemin .NET MAUI 11 (Preview 4).Files
docs/fundamentals/shell/tabs.md— new Tab badges section.docs/fundamentals/shell/flyout.md— new FlyoutItem badges section.docs/user-interface/toolbaritem.md— new Display a badge on a ToolbarItem section.Properties documented (all bindable, default
null)BadgeText(string) — non-empty = text/count, empty = dot indicator, null = hidden.BadgeColor(Color) — badge background; null = platform default.BadgeTextColor(Color) — badge foreground; null = platform default.Verified against
dotnet/mauibranchnet11.0:src/Controls/src/Core/Shell/BaseShellItem.cs—BadgeText/BadgeColor/BadgeTextColorBindableProperties (OneWay).src/Controls/src/Core/Toolbar/ToolbarItem.cs— same three properties onToolbarItem. Platform notes call out iOS 26UIBarButtonItem.Badgerequirement and primary-only display per the in-source remarks.Platform mapping captured: Android
BadgeDrawable, iOS/MacCatalystUITabBarItem.BadgeValue/UIBarButtonItem.Badge(iOS 26+), WindowsInfoBadge(numeric only).Internal previews