HarmonyOS 7 关怀模式切换后页面没变：启动查询、实时监听与本地偏好冲突

用户在系统设置里打开关怀模式，应用首页字体变大了，已经打开的详情页却保持原样；重新启动后又被应用内旧开关覆盖。问题不是少调一次字体，而是系统状态、应用本地偏好和当前页面渲染没有一个明确的优先级。

从 API 26.0.0 开始，应用可以查询系统关怀模式状态，并监听状态变化；已经实现独立关怀模式的应用还可以通过 module metadata 接入系统管理页面。

证据边界：本文依据华为开发者官网截至 2026-09-21 的公开文档整理。当前本机 DevEco SDK 为 API 24，且没有连接 HDC 真机；文中的 API 26 接口片段用于说明接入边界，不宣称已完成 API 26 编译或真机实测。文中纯状态机、排序、幂等和预算逻辑已用 Node.js 宿主测试验证，正式上线仍需在 API 26 SDK 与目标设备上完成编译、授权、异常分支和性能验收。

先决定产品是哪一种模式

跟随模式：应用没有独立开关，系统开关是唯一来源。独立模式：应用有自己的关怀模式，但关闭系统关怀模式时应用也应同步关闭；重新开启后的恢复规则要与官方说明和产品承诺一致。

interface SeniorPreference { systemEnabled: boolean; appEnabled: boolean; independent: boolean }
function effectiveSeniorMode(p: SeniorPreference): boolean {
  if (!p.systemEnabled) return false;
  return p.independent ? p.appEnabled : true;
}

案例一：阅读页要在运行中立即更新

应用启动时调用 isSeniorModeEnabled 只能得到初值。用户切到系统设置修改后再回应用，如果没有注册 onSeniorModeStateChange，当前进程不会自动刷新。监听回调应更新统一状态仓库，所有页面从同一状态派生字号、间距和触控尺寸。

interface SeniorTokens { body: number; title: number; touch: number; spacing: number }
function tokens(enabled: boolean): SeniorTokens {
  return enabled
    ? { body: 22, title: 30, touch: 56, spacing: 16 }
    : { body: 16, title: 24, touch: 44, spacing: 12 };
}

数字只是示例，正式值要结合设计规范、设备尺寸和可访问性测试确定。关怀模式不是把所有字号乘 1.5，长标题、表格和底部按钮都要重新验收。

案例二：支付确认页不能只放大文字

确认金额的页面如果只放大字体，却保留 32vp 的小关闭按钮和相近颜色，操作风险反而更高。关怀模式应同时调整触控热区、信息层级、对比度、危险操作间距和语义朗读。

金额、收款方和确认动作要保持固定顺序；页面重排后屏幕朗读焦点顺序也必须与视觉顺序一致。

监听生命周期

应用级状态仓库在进程初始化时查询并订阅，进程退出或模块不再使用时取消监听。不要让每个页面各自订阅，否则页面多次进入后会收到重复事件，也难以判断谁负责清理。

常见冲突

冲突	处理建议
系统关闭、本地仍为开启	有效状态立即关闭
系统开启、本地独立开关关闭	独立模式下尊重产品规则
页面缓存旧 token	状态仓库变更后重建派生样式
字号增大导致按钮截断	改为自适应高度并做最长文本测试

验收清单

• 冷启动正确读取系统状态。
• 应用运行中切换系统设置可立即生效。
• 监听只注册一次并能取消。
• 字号、触控区、间距、对比度和朗读顺序一起验收。
• 手机、平板和折叠屏最长文本不截断。
• 本地偏好与系统开关的优先级有产品说明。

官方资料

• 应用声明接入系统关怀模式
• 获取系统关怀模式状态
• Accessibility Kit API 26 变更

关怀模式是应用状态与交互系统，不是一个“大字主题”。查询、监听、偏好冲突和页面验收闭环后，用户切换才真正可靠。