onnavigationbarsearchinputchanged仅在app端生效，监听原生标题栏搜索框的实时输入变化，每次按键（含删除、中文确认后）触发，参数e.text返回当前已确认文本。
onNavigationBarSearchInputChanged 能监听到什么
这个生命周期函数只在 App 端（iOS / Android）生效，H5 和小程序**完全不触发**。它监听的是原生标题栏中 searchInput 的实时输入变化，每次按键（包括删除、中文拼音输入过程中的候选字切换）都会调用，参数 e 是一个对象，关键字段是 e.text —— 注意：它返回的是当前已确认的文本，不是拼音草稿；中文输入法下，只有用户点击“完成”或按回车后才会更新，中间选词过程不会反复触发。
为什么 onNavigationBarSearchInputConfirmed 拿不到 e.text
常见错误是直接写 onNavigationBarSearchInputConfirmed() { console.log(e.text) }，但没声明参数。这个回调的参数名必须显式写出，且不能省略：onNavigationBarSearchInputConfirmed(e)。否则 e 是未定义的，e.text 会报 Cannot read property 'text' of undefined。另外，该事件仅在用户点击软键盘“搜索”按钮（或回车键）时触发，不响应失焦或点击空白处等行为。
如何让搜索框自动聚焦并支持清空逻辑
聚焦和清空不能靠 v-model 或绑定数据实现，必须通过 WebView API 控制：
- 聚焦：在
onReady或按钮点击后执行webView.setTitleNViewSearchInputFocus(true) - 清空内容：调用
webView.setTitleNViewSearchInputText('')，注意这不是 setData，不会触发 Vue 响应式更新 - 获取当前值：只能靠
onNavigationBarSearchInputChanged的回调缓存，没有同步读取方法 - 失焦控制：传
false给setTitleNViewSearchInputFocus，但部分 Android 机型存在延迟或失效，建议配合uni.hideKeyboard()双保险
pages.json 配置 searchInput 后仍不显示的典型原因
原生搜索框依赖 titleNView 开启，且必须关闭默认导航栏："navigationStyle": "custom" 是前提。常见漏配点：
- 没在
app-plus下配置titleNView.searchInput，H5 小程序侧配置无效 -
searchInput写成了searchinput（iOS 下大小写敏感，旧版 HBuilderX 有此 bug） - 页面使用了自定义组件库（如 uView、uv-ui）的导航栏，实际遮挡了原生
titleNView - Android 真机调试时未勾选「启用原生标题栏」选项（HBuilderX 运行设置里）
最稳的验证方式：在 pages.json 中只保留最小配置，先确保搜索框能出来，再逐步加样式和事件。
