HarmonyOS 7.0 / API 26 多窗口输入焦点治理：鸿蒙电脑和平板为什么会抢输入框

这篇只讲一个点：多窗口输入焦点和键盘事件边界。版本边界先说清楚：下面的写法面向 HarmonyOS 7.0 / API 26。老版本工程不要直接照搬，先确认 SDK、DevEco Studio、设备系统版本和模拟器镜像是否一致。

先说它解决什么

同一个页面在手机上正常，放到平板或鸿蒙电脑多窗口后，快捷键、输入框焦点和页面返回会互相影响。

如果还按 5.0 或 6.0 的旧习惯处理，通常会遇到三个问题：第一，代码能编译，但设备上行为和预期不一致；第二，页面状态看起来正常，切换场景后就暴露边界；第三，性能或体验问题不是马上炸，而是用户连续操作后才出现。

容易复现的两个场景

场景一：输入框聚焦时全局快捷键仍然生效

复现方式很简单：先把页面打开到目标状态，再连续做两次切换或刷新。这个时候要观察的不是按钮有没有响应，而是状态有没有丢、动画有没有抖、资源有没有重复申请。

场景二：窗口缩放后焦点回到旧组件

第二个场景更接近线上问题：用户不是按开发者预设路径走，而是会来回切页面、锁屏、恢复、换方向、切到后台再回来。这个时候如果只看单次点击，问题会被遮住。

最小 Demo

@Observed
class PageModel {
  query: string = ''
  loading: boolean = false
}

@Component
struct StateBoundaryView {
  @ObjectLink model: PageModel
  build() {
    Column({ space: 12 }) {
      TextInput({ text: this.model.query }).onChange(v => this.model.query = v)
      LoadingProgress().visibility(this.model.loading ? Visibility.Visible : Visibility.Hidden)
    }
  }
}

这个 Demo 的重点不是炫技，而是把问题压到最小：一个入口、一个状态变化、一个验证点。先把这个跑通，再往复杂页面里搬，排查成本会低很多。

我会怎么选方案

我的选择是第三种。只要这个能力会被多个页面用到，就不要把判断逻辑塞在页面里。页面只负责展示，能力边界、异常兜底、版本判断放到独立函数或组件里。这样后面改 SDK、换设备、补兼容逻辑，影响面会小很多。

验证清单

• DevEco Studio 使用支持 HarmonyOS 7.0 / API 26 的版本。
• 真机或模拟器系统版本和文章里的 API 版本一致。
• 至少跑通上面两个场景，不只看首屏。
• 如果涉及多设备、窗口、后台恢复，要补一次切换测试。
• 如果要发到线上，日志里要能看出失败原因，而不是只看到一个空状态。

最后总结

多窗口不是把宽度变大就结束，焦点归属和快捷键边界必须单独处理。

这类特性真正有价值的地方，不是知道一个新名字，而是知道它在什么场景该用、什么时候不该用、怎么复现问题、怎么把修复沉淀成可复用代码。后面再接复杂页面时，先把这个小 Demo 跑通，基本能避开一半低级返工。

两个案例怎么验证

案例 A 先跑最小页面。只保留一个入口、一个状态字段、一个日志输出。验证时连续触发三次，看日志顺序是不是稳定，页面有没有旧状态回跳。这个案例用来证明能力本身可用，也用来排除“项目代码太复杂导致看不清”的干扰。

案例 B 再加一个真实边界：切后台再回来、窗口宽度变化、设备能力不支持、权限被拒绝、或者网络慢一拍。这个案例用来验证兜底路径。很多线上问题不是主流程不通，而是异常路径没有闭环，所以第二个案例必须保留。

我会重点看哪几条日志

为什么这个角度值得收藏

多窗口输入焦点治理 这种问题表面看是一个小交互，实际上连着版本、设备、状态和兜底。文章里不只给一个能跑的片段，还把失败路径单独列出来。后面你换成自己的页面时，可以先照着这张表做一轮自检：入口有没有重复触发，状态有没有旧值，设备不支持时有没有退路，日志能不能定位到哪一步。

后续扩展

如果这个能力要放进正式项目，我不会直接把代码塞进页面里，而是会抽一层 FocusBoundaryController。页面只传入输入和展示状态，能力层负责判断版本、设备、权限、异常和日志。这样做的收益是：一个页面出问题时不会把所有页面一起拖下水；后面 HarmonyOS 7.0 / API 26 继续更新时，也只需要改一个入口。