Document public Material 3 helper types in .NET MAUI 11#3369
Conversation
Adds a "Customize Material 3 controls" section that enumerates the Microsoft.Maui.Platform Material 3 helper types now exposed as public in .NET MAUI 11 (MauiMaterialEditText, MauiMaterialPicker, MauiMaterialDatePicker, MauiMaterialTimePicker, MauiMaterialTextView, MauiMaterialSearchBarTextInputLayout, MaterialActivityIndicator, MauiMaterialContextThemeWrapper). Includes a handler-customization example that subclasses MauiMaterialEditText for Entry. Tracks dotnet/maui#35323 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 status updates of commit 9b4c81a:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/user-interface/material-design.md | View (>=net-maui-8.0) | Details |
docs/user-interface/material-design.md
- Line 292, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialEditText'. - Line 292, Column 57: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.EditorHandler2'. - Line 293, Column 50: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.PickerHandler2'. - Line 294, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.DatePickerHandler2'. - Line 295, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.TimePickerHandler2'. - Line 296, Column 68: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.SearchBarHandler2'. - Line 299, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialContextThemeWrapper'.
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.
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 |
There was a problem hiding this comment.
Pull request overview
Adds .NET MAUI 11 documentation for customizing Android Material 3 controls by subclassing newly-public Microsoft.Maui.Platform helper types and swapping them in via Handler2 platform view factories.
Changes:
- Adds a new Customize Material 3 controls section under the
>=net-maui-11.0moniker, including a helper-types-to-Handler2 mapping table. - Adds an Android
PlatformViewFactoryexample forEditorHandler2that subclassesMauiMaterialEditText. - Updates the page
ms.date.
|
Learn Build status updates of commit d6ad0ca:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/user-interface/material-design.md | View (>=net-maui-8.0) | Details |
docs/user-interface/material-design.md
- Line 292, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialEditText'. - Line 292, Column 57: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.EditorHandler2'. - Line 293, Column 50: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.PickerHandler2'. - Line 294, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.DatePickerHandler2'. - Line 295, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.TimePickerHandler2'. - Line 296, Column 68: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.SearchBarHandler2'. - Line 299, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialContextThemeWrapper'.
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.
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 |
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 |
|
Learn Build status updates of commit d6ad0ca:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/user-interface/material-design.md | View (>=net-maui-8.0) | Details |
docs/user-interface/material-design.md
- Line 292, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialEditText'. - Line 292, Column 57: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.EditorHandler2'. - Line 293, Column 50: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.PickerHandler2'. - Line 294, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.DatePickerHandler2'. - Line 295, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.TimePickerHandler2'. - Line 296, Column 68: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.SearchBarHandler2'. - Line 299, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialContextThemeWrapper'.
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.
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 |
|
Learn Build status updates of commit aaa44d4:
|
| File | Status | Preview URL | Details |
|---|---|---|---|
| docs/user-interface/material-design.md | View (>=net-maui-8.0) | Details |
docs/user-interface/material-design.md
- Line 292, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialEditText'. - Line 292, Column 57: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.EditorHandler2'. - Line 293, Column 50: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.PickerHandler2'. - Line 294, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.DatePickerHandler2'. - Line 295, Column 54: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.TimePickerHandler2'. - Line 296, Column 68: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Handlers.SearchBarHandler2'. - Line 299, Column 3: [Warning: xref-not-found - See documentation]
Cross reference not found: 'Microsoft.Maui.Platform.MauiMaterialContextThemeWrapper'.
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.
Replace unresolved xrefs for newly public .NET 11 Material 3 helper and Handler2 types with code spans so OPS validation doesn't warn before the API reference includes them. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
Learn Build status updates of commit c8f0b1d: ✅ Validation status: passed
For more details, please refer to the build report. |
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 |
Adds a "Customize Material 3 controls" section to
docs/user-interface/material-design.mdthat enumerates theMicrosoft.Maui.PlatformMaterial 3 helper types now exposed as public in .NET MAUI 11 — and maps each one to theHandler2variant that uses it as its platform view (EditorHandler2,PickerHandler2,DatePickerHandler2,TimePickerHandler2,SearchBarHandler2).Includes a complete
PlatformViewFactoryexample that subclassesMauiMaterialEditTextand is wired intoEditorHandler2. The example mirrorsEditorHandler2.CreatePlatformView(includingMauiMaterialContextThemeWrapper.Create(...)for the theme overlay,ImeOptions = ImeAction.Done,Gravity = GravityFlags.Top,TextAlignment = ViewStart, andSetSingleLine(false)/SetHorizontallyScrolling(false)) so the Material 3 theming and Editor-specific behavior aren't lost when the factory replaces the default.Tracks dotnet/maui#35323 and aligns with the .NET 11 Preview 5 release notes (dotnet/core#10433).