Skip to content

Conversation

davidortinau
Copy link
Contributor

@davidortinau davidortinau commented Aug 20, 2025

This PR adds a focused .NET 10 update to the Shell SearchHandler docs to cover programmatic soft input control.

Summary

  • Adds a >= net-maui-10.0 monikered section to docs/fundamentals/shell/search.md
  • Documents SearchHandler.ShowSoftInputAsync and SearchHandler.HideSoftInputAsync
  • Provides small C# examples for auto-showing the keyboard on page appear and hiding it on item selection
  • Updates ms.date

Motivation and migration

  • Prior to .NET 10, soft input control for text inputs was via SoftInputExtensions on ITextInput (Entry, Editor, SearchBar). SearchHandler did not have dedicated APIs to show/hide the soft input keyboard without focus gymnastics or platform code.
  • In .NET 10, SearchHandler adds first-class methods to manage the soft input keyboard. This enables better UX patterns (auto-open at page load, dismiss on selection) without altering focus.

Source/API references

  • API: SearchHandler.ShowSoftInputAsync (net-maui-10.0)
  • API: SearchHandler.HideSoftInputAsync (net-maui-10.0)

Notes

  • Section is fully monikered and linted; minimal change footprint per our .NET 10 docs update process.

Files changed

  • docs/fundamentals/shell/search.md

ms.date

  • Updated to 2025-08-20.

Internal previews

📄 File 🔗 Preview link
docs/fundamentals/shell/search.md docs/fundamentals/shell/search

…owSoftInputAsync/HideSoftInputAsync); add monikered section and examples; update ms.date
@davidortinau davidortinau requested a review from a team as a code owner August 20, 2025 20:10
Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. 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.

Copy link

Learn Build status updates of commit 45852b4:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/search.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@davidortinau davidortinau requested a review from Copilot August 20, 2025 20:16
Copy link
Contributor

@Copilot Copilot AI left a comment

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 adds .NET 10-specific documentation for programmatic soft input keyboard control in Shell SearchHandler. The update introduces two new async methods that allow developers to show and hide the soft keyboard without manipulating focus, addressing a common UX need for search interfaces.

  • Documents new ShowSoftInputAsync and HideSoftInputAsync methods available in .NET 10
  • Provides practical code examples for auto-showing keyboard on page appearance and hiding it after item selection
  • Uses proper DocFX monikers to isolate .NET 10-specific content

Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. 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.

Copy link

Learn Build status updates of commit 47df0a7:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/search.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

Copy link

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. 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.

Copy link

Learn Build status updates of commit 153691b:

✅ Validation status: passed

File Status Preview URL Details
docs/fundamentals/shell/search.md ✅Succeeded View (>=net-maui-8.0)

For more details, please refer to the build report.

@jfversluis jfversluis merged commit e68ab28 into main Aug 27, 2025
5 checks passed
@jfversluis jfversluis deleted the pr10-searchhandler-softinput-from-main branch August 27, 2025 08:24
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.

2 participants