Skip to content

fix(shelf): contact-sheet a11y 加固 —— 提示横幅合并朗读 + grid region (#86) - #91

Merged
sweetcornna merged 2 commits into
mainfrom
a11y/contact-sheet-86
Jul 26, 2026
Merged

fix(shelf): contact-sheet a11y 加固 —— 提示横幅合并朗读 + grid region (#86)#91
sweetcornna merged 2 commits into
mainfrom
a11y/contact-sheet-86

Conversation

@sweetcornna

Copy link
Copy Markdown
Owner

概要

落实 #86 的两项代码侧加固:

  • 提示横幅contactSheetHintBanner.accessibilityElement(children: .combine) + .accessibilityAddTraits(.isHeader) + .accessibilityHint("双击「知道了」可关闭此提示").combine 会把子按钮动作降为 rotor 自定义操作,故补一个默认 accessibilityAction,保证 hint 里说的「双击关闭」真的可用;可视按钮与 VO 动作共用新抽的 dismissContactSheetHint()
  • grid regioncontactSheetGrid 整体 .accessibilityElement(children: .contain) + label「样片小样张」,VoiceOver rotor「容器」里可作为一站跳转。

契约确认

  • XCUI cells.count 契约不破:改动仅在 contactSheet 布局路径,XCUI 测试默认走 .listvoxuleApp init 在测试环境显式重置 shelf.layout)。

回归

  • swift test 141 测例全过
  • scripts/run-sim.sh --build-only BUILD SUCCEEDED
  • scripts/check-clinical-words.sh 无命中

遗留(需真机/人工,见 #86 勾选项)

  • VoiceOver 实听一遍,确认横幅一次读完、hint 正确
  • rotor 容器跳转实测

Closes 不自动关 —— #86 留给 VoiceOver 实听后手动关。

- contactSheetHintBanner 整块 .combine 成单元素 + .isHeader + hint,
  VoiceOver 一次读完「这是一条可关闭的提示」;补默认 accessibilityAction
  保证 combine 后双击仍能关闭(可视按钮与 VO 动作共用 dismissContactSheetHint)
- contactSheetGrid 整体 .contain + label「样片小样张」,rotor 容器可跳转
- XCUI cells 契约不受影响:改动仅在 contactSheet 布局,XCUI 默认走 .list
@sweetcornna
sweetcornna merged commit c2d6541 into main Jul 26, 2026
1 check failed
@sweetcornna
sweetcornna deleted the a11y/contact-sheet-86 branch July 26, 2026 13:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant