Skip to content

Document Material 3 Android control visuals and platform notes #3284

Draft
SyedAbdulAzeemSF4852 wants to merge 2 commits intodotnet:mainfrom
SyedAbdulAzeemSF4852:material3-doc
Draft

Document Material 3 Android control visuals and platform notes #3284
SyedAbdulAzeemSF4852 wants to merge 2 commits intodotnet:mainfrom
SyedAbdulAzeemSF4852:material3-doc

Conversation

@SyedAbdulAzeemSF4852
Copy link
Copy Markdown

This pull request updates the Material 3 documentation for .NET MAUI, focusing on Android control rendering when UseMaterial3 is enabled. It adds Material 2 vs Material 3 visual comparisons for supported controls, clarifies Android-only Material 3 behavior, and includes links to the underlying Android components.

Documentation improvements for Material 3 in .NET MAUI:

General updates and clarifications:

  • Clarified that Material 3 styling only applies on Android when UseMaterial3 is set to true, and that other platforms are unaffected.
  • Updated the page date for accuracy.

Control-specific Material 3 documentation and visuals:

  • Added detailed sections for each supported control (Entry, Editor, SearchBar, RadioButton, ProgressBar, Slider, Picker, TimePicker, DatePicker), describing their new Material 3 appearance, with side-by-side screenshot comparisons to Material 2, and links to the underlying Android components.
  • For DatePicker, documented the new Material 3 full-screen calendar overlay, immutable calendar constraints, and added an important note about MinimumDate and MaximumDate behavior.

@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 f7cbf4c:

💡 Validation status: suggestions

File Status Preview URL Details
docs/user-interface/media/material3/material2-datepicker.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-editor.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-entry.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-picker.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-progressbar.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-radiobutton.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-searchbar.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-slider.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material2-timepicker.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-datepicker.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-editor.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-entry.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-picker.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-progressbar.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-radiobutton.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-searchbar.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-slider.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/media/material3/material3-timepicker.png 💡Suggestion View (>=net-maui-8.0) Details
docs/user-interface/material-design.md ✅Succeeded View (>=net-maui-8.0)

docs/user-interface/media/material3/material2-datepicker.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-editor.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-entry.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-picker.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-progressbar.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-radiobutton.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-searchbar.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-slider.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material2-timepicker.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-datepicker.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-editor.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-entry.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-picker.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-progressbar.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-radiobutton.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-searchbar.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-slider.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

docs/user-interface/media/material3/material3-timepicker.png

  • Line 0, Column 0: [Suggestion: image-name-incomplete - See documentation] The image name contains an incomplete word, misspelled word, acronym, or abbreviation that is disallowed.

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.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant