Day 105

SwiftUI accessibilityElement like UIKit grouping

31 Aug 2022

The .accessibilityElement(children: ) modifier with the .ignore argument does a similar thing to set the container view to be an accessibility element in UIKit. It is the default argument, so you can just say .accessibilityElement().

Two instances of the Stock Analyzer app showing you what it is included with the pro version and how much it costs. The first one uses .accessibilityElement(children .combine) to group three elements, and that causes VoiceOver to announce

Because of this, you'll need to use other modifiers to make it accessible and manually configure an accessibility label and value, traits... when necessary.

https://developer.apple.com/documentation/swiftui/view/accessibilityelement(children:)

https://developer.apple.com/documentation/swiftui/accessibilitychildbehavior/ignore

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 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.

Day 92

Create UIAccessibilityElement for custom drawing

You can create your own accessibility elements from scratch. One use-case for doing that is when you do some custom drawing instead of building your UI using or relying on UIKit components. A circular progress bar, could be an example.

UIKit accessibilityElement accessibilityElements

Day 109

SwiftUI contain mirrors semanticGroup

The equivalent of using a .semanticGroup accessibilityContainerType in UIKit, would be to use the .accessibilityElement(children: ) modifier with the .contain option in SwiftUI. Here's a refresher with some use-cases: https://x.com/dadederk/status/1558790851496742914

SwiftUI UIKit accessibilityContainer accessibilityElement

← Day 106

Day 104 →