Day 227

accessibilitySortPriority for VoiceOver order

2 Jan 2023

VoiceOver will traverse elements from left-right, and from top-bottom. If for any reason you need to change that order, in SwiftUI you can change the accessibility sort priority. A higher priority number in the container means it will go first.

There are five buttons labeled with A, B, C, D, E. The A button is first, B is underneath it, and C, D, and E are under B. The natural order with VoiceOver would be A, B, C, D, E. There is some code that gives C a sort priority of 2, D a sort priority of 3, and E a sort priority of 1. That means that the order will be A, B, D, C, E instead.

Some of you have asked me how you can support what I do. This would really help, and would be hugely appreciated:

Find these posts useful? Share them at work, on social media, or with anyone that might find them interesting. Let's spread the word!
Check out any of my apps or games: Xarra!, RetroRapid!, or Mestre!.
- A download and a review go a long way. They're free by default. On the App Store, ratings and reviews really help more people discover them.
- Finding any of them useful? If so, and if you can afford it, purchasing lifetime access to all features or subscribing lets me buy the coffee that keeps me caffeinated. Caffeine keeps me going to maintain the apps, bring in new features that I hope you'll love, and keep writing.

You may also find interesting...

Day 102

Set AXCustomContent importance for VoiceOver

When creating AXCustomContent objects for accessibilityCustomContent, you can specify the importance of the data. If it is high, it will always be presented by VoiceOver. You could potentially ask the user if that data is of importance to them.

Day 44

Mark decorative images as non-accessible

If an image does not convey additional information, maybe it's just used to make the UI look more attractive, it makes sense for VoiceOver to skip it. UIKit: set isAccessibilityElement to false. SwiftUI: create a decorative image explicitly.

SwiftUI UIKit VoiceOver accessibilityElement

Day 111

Use disabled instead of notEnabled in SwiftUI

In SwiftUI you won't find the .notEnabled accessibility trait. Instead, you can just configure a view as such with .disabled(true), and pass false to enable it. VoiceOver will announce it as "dimmed". https://developer.apple.com/documentation/swiftui/view/disabled(_:)

SwiftUI VoiceOver

← Day 228

Day 226 →