原生导航栏搜索框无法用 DOM 方法聚焦，必须调用 setTitleNViewSearchInputFocus API；因其为原生控件，不在 WebView 的 DOM 树中，uni.createSelectorQuery 和 ref.focus() 均无效。
原生导航栏的搜索框无法用 DOM 方法聚焦，必须走 setTitleNViewSearchInputFocus API，否则在 App 端完全无效。
为什么不能用 uni.createSelectorQuery 或 ref.focus()
原生导航栏（navigationStyle: "default" 或 "custom" 但启用 nvue 导航栏）的搜索框是原生控件，不在 WebView 的 DOM 树中。所有基于 CSS 选择器或 Vue ref 的操作都查不到它——uni.createSelectorQuery().select('.xxx') 返回 null，this.$refs.xxx?.focus() 报错或静默失败。
- 只适用于页面内自定义的
<input>或<uni-search-bar>，不适用于原生导航栏内置搜索框 - 微信小程序端即使配置了
searchInput: true，其输入框仍是原生层，同样不可 DOM 操作 - 试图在
onReady或mounted里轮询查节点，纯属浪费时间
正确做法：调用 setTitleNViewSearchInputFocus(true)
这是 uni-app 官方唯一支持的原生导航栏搜索框聚焦方式，仅适用于 App 平台（iOS / Android），需配合 pages.json 中的 nvueStyle 或原生导航栏配置使用。
- 先获取当前页面 webview 实例：
const webView = this.$mp.page.$getAppWebview() - 再调用：
webView.setTitleNViewSearchInputFocus(true) - 失焦同理：
webView.setTitleNViewSearchInputFocus(false) - 必须确保页面已加载完成，建议放在
onReady或用户触发动作（如点击搜索图标）的回调中
常见错误与兼容性注意
这个 API 表面简单，但踩坑点密集：
- 只在 App 端生效，H5 和小程序端调用无反应，也不报错——务必加平台判断：
if (uni.getSystemInfoSync().platform === 'ios' || uni.getSystemInfoSync().platform === 'android') - 若页面未配置原生搜索框（
pages.json中未设"searchInput": true），调用后无任何效果 - 部分安卓机型（尤其旧版 WebView）需延迟 100ms 再调用，否则可能失效：
setTimeout(() => webView.setTitleNViewSearchInputFocus(true), 100) - 聚焦后软键盘弹起，若页面内容被顶起，需在
pages.json中配置"softinputMode": "adjustPan"，否则布局错乱
如何监听原生搜索框的输入和确认事件
原生导航栏搜索框的内容无法通过 v-model 绑定，必须监听生命周期函数：
- 输入过程：
onNavigationBarSearchInputChanged(e)，e.text是当前值 - 点击软键盘「搜索」或「回车」：
onNavigationBarSearchInputConfirmed(e)，e.text是最终关键词 - 点击清空按钮：
onNavigationBarSearchInputClicked()，此时输入框变空，但不会触发 changed - 这些函数必须写在页面级
export default的 methods 外层，且不能带methods:前缀
原生导航栏搜索框的焦点控制本质是平台能力桥接，不是前端 DOM 操作。绕开 setTitleNViewSearchInputFocus 去折腾 ref 或 query，只会浪费半天还跑不通。真要跨平台一致体验，不如放弃原生搜索框，改用页面内吸顶的 <input> + 自定义样式——虽然少了一点“原生感”，但逻辑可控、调试可见、iOS/Android/H5 全平台行为统一。
