Ios Voiceover Order
Ensure VoiceOver reads elements in a logical, content-meaningful order; use .accessibilitySortPriority() to override layout-driven order when the visual position produces a nonsensical traversal sequence.
$ aoe install @community/rule-ios-voiceover-orderProjection
Always in _index.xml · the agent never has to ask for this.
IosVoiceoverOrder [rule] v1.0.0
Ensure VoiceOver reads elements in a logical, content-meaningful order; use .accessibilitySortPriority() to override layout-driven order when the visual position produces a nonsensical traversal sequence.
Loaded when retrieval picks the atom as adjacent / supporting.
IosVoiceoverOrder [rule] v1.0.0
Ensure VoiceOver reads elements in a logical, content-meaningful order; use .accessibilitySortPriority() to override layout-driven order when the visual position produces a nonsensical traversal sequence.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Applies To
any iOS screen where visual layout order does not match logical reading order (e.g., multi-column layouts, overlaid cards, Z-layered views)
Loaded when retrieval picks the atom as a focal / direct hit.
IosVoiceoverOrder [rule] v1.0.0
Ensure VoiceOver reads elements in a logical, content-meaningful order; use .accessibilitySortPriority() to override layout-driven order when the visual position produces a nonsensical traversal sequence.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Applies To
any iOS screen where visual layout order does not match logical reading order (e.g., multi-column layouts, overlaid cards, Z-layered views)
Examples
- A product card with price on the left and rating on the right: ensure price is read before rating.
- .accessibilityElement(children: .combine) on a label+value row to announce them as one unit.
- Verify: navigate with VoiceOver swipe-right; elements must be announced in semantic, not positional, order.
Relations
related: [@community/rule-ios-voiceover-labels, @community/rule-ios-reduce-motion, @community/check-ios-bold-text-support]
Rationale
Out-of-order VoiceOver navigation is disorienting and can make content incomprehensible for blind users. Two-column or grid layouts are frequently read in Z-order (top-left → top-right → second-left → second-right) when a row-first order would be semantically correct.
Meta
- License: Apache-2.0
- License Provenance: package-authorship-claim
Applies To
any iOS screen where visual layout order does not match logical reading order (e.g., multi-column layouts, overlaid cards, Z-layered views)
Source
aoe-engine/examples/frontend-design/primes/compiled/@community/rule-ios-voiceover-order/atom.yaml