【多设备与多窗口】无障碍票务终端·第2篇:HarmonyOS 优惠卡片合并朗读【共创稿事节】
一张票价卡里的徽章、数字与说明被逐项播报,难以理解实际金额。若把这样的反馈直接归类成“设备兼容”,就无法定位真正原因。居民希望核对优惠是否符合自己的证件类型,因此用户重视的不是窗口看起来是否饱满,而是操作序列能不能被完整继承。本文把优惠卡片作为分析单位,从状态归属、展示分配和异常回退三条线排查。

01|从现场问题找到可复现的链路
本项目先区分三种状态:可以从业务数据重新计算的展示状态、尚未提交的用户编辑状态、已经确认的业务结果。票价、优惠名称、有效条件中需要被跨布局保留的部分单独归档,而优惠卡片的可见宽度、列数和边距属于当前窗口。二者的生命周期不相同。若把它们压进一个全局布尔变量,看似减少代码,实际上会在第二个窗口存在时制造互相覆盖。
居民希望核对优惠是否符合自己的证件类型要求界面对变化保持弹性,但并不意味着每次变化都要重新获取全部数据。关键区别在于数据源是否更换、可见对象是否变动,以及仅仅改变了容器尺寸。对票价优惠来说,最小更新单位是优惠卡片和其唯一标识;在需求评审阶段就写清这个边界,后续才能判断哪个组件应该订阅哪个状态。
结合票价优惠的业务流程,可以按“先确定对象、再改变容器、最后执行动作”安排重现步骤。第一步将优惠条件设置为固定记录,第二步保持票价、优惠名称、有效条件不变,第三步触发“阅读器连续读出四个碎片却不讲清“可使用优惠”条件”。如果优惠卡片发生身份变化,优先检查状态键和回调订阅;如果只是按钮被遮挡,则检查可见区域。两种原因的处理策略不能互相替代。不能把包含多个按钮的父容器全部强制合并。
02|状态归属比窗口尺寸更重要
设计方案需要把一次普通窗口变化与一次业务提交区分开。阅读器连续读出四个碎片却不讲清“可使用优惠”条件只能改变呈现策略,不能自动触发优惠卡片写回。将语义上不可拆的文字组合成一个访问节点,保留单独按钮意味着刷新策略可以反复执行而结果相同;即使系统先后触发两次尺寸变更,已确认内容也不会重复提交。性能优化应该在这个正确性前提下进行,否则快速刷新只是更快地放大错误。
实现上采用将语义上不可拆的文字组合成一个访问节点,保留单独按钮。不要先重做页面再试图找回用户之前点过的位置;更合理的顺序是先锁定票价、优惠名称、有效条件,再计算当前可用区域,最后映射为优惠卡片的布局表达。映射过程尽量做成无副作用函数:输入是不可变业务快照和窗口宽度,输出是结构配置,既不能写数据库,也不能暗中改变业务选择。
对这个问题最危险的修复是扩大点击区域或隐藏溢出的组件。这些改动容易掩盖阅读器连续读出四个碎片却不讲清“可使用优惠”条件导致的根因:业务状态和视觉状态之间缺少稳定关联。更稳妥的方式是将异常重现到最小场景,固定优惠卡片记录,依次切换窗口条件、输入方式和数据筛选,并记录每次操作应该改变的字段。

03|把决策落实到组件与数据
排查时应把触摸、键盘和窗口变形视作同一个会话中的事件,而不是各自独立的小功能。优惠卡片一旦被选中,后续焦点变化并不必然代表用户放弃选择。尤其是居民希望核对优惠是否符合自己的证件类型,视觉高亮、键盘焦点、业务选择三个概念不能用一个字段表达。不同设备上的输入习惯可以不同,但最终动作必须指向相同的业务ID。
验证不应只拍一张完成态界面。准备一条连续的操作序列:先选中一项优惠卡片,输入一段尚未确认的优惠条件信息,改变窗口宽度,再切回原宽度并执行确认。每一步核对票价、优惠名称、有效条件是否符合预期。只要记录的业务ID没有发生改变,视觉组件重新排列就是允许的;一旦业务对象悄悄变化,即使页面外观正常也应判为缺陷。
下面的最小界面代码重点示例状态与操作如何绑定。它是独立可读的 ArkUI 页面片段,业务存储与多设备调度另有职责;不要把界面按钮的视觉提示当作数据库提交成功。IDE或竖屏页面图用于说明元素对应关系,实际接口适用性还需以项目采用的SDK及设备模式确认。
@Entry
@Component
struct WorkPanel7 {
@State selected: boolean = false;
@State showDetails: boolean = false;
build() {
Column({ space: 16 }) {
Text('票价优惠').fontSize(24).fontWeight(FontWeight.Bold)
Row({ space: 10 }) {
Text('优惠卡片:优惠条件').layoutWeight(1)
Button(this.selected ? '已确认' : '选择')
.onClick(() => this.selected = !this.selected)
.accessibilityText(this.selected ? '已选择优惠卡片' : '选择优惠卡片')
}
.padding(12)
.accessibilityGroup(false)
Button(this.showDetails ? '收起说明' : '查看说明')
.onClick(() => this.showDetails = !this.showDetails)
if (this.showDetails) {
Text('不能把包含多个按钮的父容器全').fontSize(16).accessibilityLevel('yes')
}
}.padding(20).width('100%')
}
}
我会把测试结果分成三类:结构是否正确、交互是否可达、数据是否可信。结构包含可见区域与滚动容器;交互包含按钮、键盘焦点和读屏标签;数据检查票价、优惠名称、有效条件是否保留。只有后两类也通过,才算适配完成。设备没有覆盖的场景不能写成运行成功,而应该列入后续真实设备验证项目。

04|边界事件、错误回退与可访问性
维护者最容易忽略的边界是关闭和重新打开。窗口消失不代表业务必须提交,组件卸载也不意味着记录应该删除。要明确票价、优惠名称、有效条件哪些属于会话、哪些属于持久记录,并规定过期清理时机。尤其当优惠卡片内容包含用户输入,退出路径应提供显式保存或放弃逻辑,不应让系统回调代替业务决定。
在性能和可靠性之间,正确性优先。比如优惠卡片的缓存可以降低重复创建,但缓存中若携带旧的优惠条件状态,复用反而更危险。可以缓存布局或不可变资源,却要在绑定新数据时重新确认业务主键。出现冲突时宁可短暂显示加载或待确认提示,也不要把错误记录当成已经完成的操作。
与视觉团队对齐时,应明确哪些动效只是装饰、哪些交互承担确认功能。优惠卡片切换布局的过程中,可以短暂改变卡片顺序,但不可让焦点突然落入不可见控件。输入状态发生迁移时,应该告诉用户新的焦点位置,不能要求他们重新猜测。UI评审如果只检查鼠标点击,会漏掉键盘和读屏路径。
05|验证路径及工程取舍
可访问性检查要同样遵守业务语义。优惠卡片在大屏可能展示成多列,在窄窗变成单列,但朗读名称、是否可操作以及当前状态应保持一致。尤其对居民希望核对优惠是否符合自己的证件类型,不能仅依靠颜色、图标或悬停表达关键结果。即便本文关注性能或布局,也应至少确保键盘能够到达主要控件,且控件有可理解的文字说明。
错误分级也很重要:一张票价卡里的徽章、数字与说明被逐项播报,难以理解实际金额是会让业务对象改变的问题,优先级高于边框轻微错位;优惠卡片不可点击则高于动画不顺;最后才是装饰性视觉差异。调试单需要记录最短路径、影响的业务字段、设备窗口状态和可复现次数。没有这些信息,团队往往只能不断增加延迟或刷新次数,反而引入新竞态。
从数据访问角度,屏幕越大不代表必须同时拉取越多内容。对票价优惠可先加载当前窗口能展示的优惠卡片集合,再把不在视野中的详细资源推迟到需要时处理。响应式布局策略与分页策略彼此独立:前者负责列数与排版,后者负责加载量。混用这两项职责,会让小窗切换频繁触发网络请求。
经过边界分析,可以把票价优惠的设计归纳成一句话:窗口负责表达,业务负责事实。将语义上不可拆的文字组合成一个访问节点,保留单独按钮使优惠卡片在不同设备形态下拥有同一身份;布局的变化只决定展示,不改变用户已经确认的内容。接下来真正值得投入的,是在目标设备上覆盖多窗切换、后台恢复和外接输入这些连续操作,而不只是检查静态首屏。
当我们讨论accessibilityGroup与级别控制时,常常先谈组件和属性,最后才谈用户到底想保留什么。这里的结论恰好相反:先确定优惠条件、优惠卡片和确认语义,再选择布局与回收策略。窗口适配可以不断演进,核心数据协议应尽量稳定。对没有实际设备验证的性能假设,则应继续用Profiler和设备操作路径检验。

无障碍服务需要一个能理解的对象,而不是视觉元素的机械堆叠。价格、优惠条件和动作按钮应分别判断是否需要组成语义组。accessibilityGroup(true)会将子节点作为一组处理,因此如果容器内还包含独立按钮,就可能隐藏可操作元素。分组前先画出朗读顺序,确认用户不依赖视觉位置也能完成流程。
对状态切换后的结果,应让控件本身的语义文字随业务值更新。不能只把灰色按钮变绿色,再期待读屏用户理解已经确认。屏幕阅读器的语速、导航策略和设备实现可能不同,所以测试时要打开实际辅助服务逐项走流程,不以开发者眼中可见的文字代替读屏结果。
实际落地时可先在不依赖系统能力的纯逻辑层验证优惠条件与状态映射,再使用DevEco Studio的设备运行环境检查窗口和输入事件。accessibilityGroup与级别控制涉及的具体系统实现必须以当前产品开放SDK和目标设备为准。没有对设备执行编译与运行时,不应该把静态代码阅读记为兼容性验证已经通过;更不应该填入未经测量的帧率、响应耗时或内存改善百分比。
对于票价优惠的优惠卡片合并朗读,需要给问题定义可判定的失败条件:一张票价卡里的徽章、数字与说明被逐项播报,难以理解实际金额。运行页面时,一边改变窗口形态一边保留票价、优惠名称、有效条件,随后检查优惠卡片是否仍然对应正确优惠条件;若发现反馈与当前对象不一致,应首先检查状态映射和事件归属,而不是立刻增加刷新次数。这能让同一种故障从“感觉有问题”变成确定的回归用例。
官方资料
更多推荐


所有评论(0)