Skip to content

Document TouchBehavior's state colors painting through Background (CommunityToolkit.Maui #3433) - #679

Draft
Brandon Minnick (TheCodeTraveler) wants to merge 2 commits into
MicrosoftDocs:mainfrom
TheCodeTraveler:docs/pr-3433-touchbehavior
Draft

Brandon Minnick (TheCodeTraveler) wants to merge 2 commits into
MicrosoftDocs:mainfrom
TheCodeTraveler:docs/pr-3433-touchbehavior

Conversation

@TheCodeTraveler

@TheCodeTraveler Brandon Minnick (TheCodeTraveler) commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

This PR coincides with the work done in CommunityToolkit.Maui PR CommunityToolkit/Maui#3433.

Breaking change: TouchBehavior's state colors are now painted as the element's Background instead of being written to BackgroundColor. On .NET MAUI 11.0.10+, that write removed a DynamicResource on BackgroundColor (dotnet/maui#38063).

  • Adds a breaking-change alert to touch-behavior.md.
  • Adds a "Background colors" section that explains how state colors are applied.
  • Adds "Migrate from v17.0.0" for a Selected visual state in a CollectionView item, with two fixes, and a note for a Button Disabled state.
  • Updates the DefaultBackgroundColor, HoveredBackgroundColor and PressedBackgroundColor rows.
  • Fixes the hover example (Background hid the hover color) and two broken source links.

This stays a draft until the CommunityToolkit.Maui release that ships CommunityToolkit/Maui#3433 is published.

🤖 Generated with Claude Code

…unityToolkit.Maui #3433)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.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 45e2442:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/behaviors/touch-behavior.md ✅Succeeded View

For more details, please refer to the build report.

…ix and the Background edge cases in CommunityToolkit.Maui #3433

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.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 0d67ee9:

✅ Validation status: passed

File Status Preview URL Details
docs/maui/behaviors/touch-behavior.md ✅Succeeded View

For more details, please refer to the build report.

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.

1 participant