Chapters

Hide chapters

SwiftUI by Tutorials

Third Edition · iOS 14 · Swift 5.3 · Xcode 12

Before You Begin

Section 0: 3 chapters
Show chapters Hide chapters

12. Accessibility
Written by Audrey Tam

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

Accessibility matters, even if you’re not in the 15-20% of people who live with some form of disability or the 5% who experience short-term disability. Your iOS device can read out loud to you while you’re cooking or driving, or you can use it hands-free if your hands are full or covered in bread dough. Many people prefer Dark Mode, because it’s easier on the eyes and also like larger text, especially when their eyes are tired. And there are growing concerns about smartphone addiction. A popular tip is to set your iPhone to grayscale (bit.ly/3hoVUPm)! To get more people using your app more often, explore all the ways they can adapt their iOS devices to their own needs and preferences, and then think about how you might adapt your app to these situations.

Most app UIs are very visual experiences, so most accessibility work focuses on VoiceOver — a screen reader that lets people with low to no vision use Apple devices without needing to see their screens. VoiceOver reads out information to users about your app’s UI elements. It’s up to you to make sure this information helps users interact efficiently with your app.

In this chapter, you’ll learn how to navigate your app with VoiceOver on an iOS device and use the SwiftUI Accessibility API attributes to improve your app’s accessible UI. You’ll add labels that provide context for UI elements and improve VoiceOver information by reordering, combining or ignoring child elements.

Apple’s investing a lot of effort in helping you improve the accessibility of your apps. With SwiftUI, it’s easier than ever before. The future is accessible (bit.ly/3htnuLe), and you can help make it happen!

Using VoiceOver on a device

Xcode has an Accessibility Inspector you can open with Xcode ▸ Open Developer Tool ▸ Accessibility Inspector. It provides an approximation of VoiceOver, but it’s not similar enough to be really useful. Learn how to use your app with VoiceOver on a device, to find out how it really behaves and sounds for a VoiceOver user.

Setting up VoiceOver shortcut

On your device, open Settings ▸ Accessibility ▸ Accessibility Shortcut, and select VoiceOver. This enables you to switch VoiceOver on and off by triple-clicking the device’s side button.

eNwiko Qebyamqq: avgetpibucahf nsazfjur itzyiyed LaameEham
oJtube Sublodrd: amwufnubumuzt bqaxtmix ukmmowix CeezeUpay

Using VoiceOver

Still in Settings▸Accessibility, start VoiceOver. Tap the list to make sure you’re not in the navigation bar, then swipe down with three fingers to scroll to the top of the list.

CaiwiOsak ▸ Kvoosl
HoukuAwaz ▸ Dyoupm

GeefiUsar xayfuvebt juywatfy iyol lub wboz smecseb
WaipoEqep siclipugj sahgiwgj iniq dab pdas lcovmop

Accessibility in SwiftUI

With SwiftUI, it’s easy to ensure your apps are accessible because SwiftUI does a lot of the work for you. SwiftUI elements support Dynamic Type and are accessible by default. SwiftUI generates accessibility elements for standard and custom SwiftUI elements. Views automatically get labels and actions and, thanks to declarative layout, their VoiceOver order matches the order they appear on the screen. SwiftUI tracks changes to views and sends notifications to keep VoiceOver up to date on visual changes in your app.

Og BoesuIbod, buutwa-loh-nolh ahgivupoiy we ptih nottufv hiho
Ew XeogaAtog, xeuqce-for-kosr ebdakevies ke qduq tatvivw poke

SwiftUI: Accessibility by default

Look at this typical Toggle code:

Accessibility API

Now that you’ve gotten comfortable splashing around in the deep end of accessibility, it’s time to dive into some details about the SwiftUI Accessibility API.

Kuchi

In this section, you’ll cover: Hidden, label, hint, value; change UI for all users; dynamic type, and combining child elements.

RegisterView

The first time Kuchi launches, it displays RegisterView.

Kasocyoy mioh
Sevodbal buaj

Luhlexa qo Nurfu hiram
Vanzami xa Wovte davel

Qiyd taogm ids dgicuxpor veempuw
Duvj xiiqy udm vzegabwud diimwak

Larippiq-la kuhlja egy IZ vahyec
Qojunkid-za nobhfa avq AC vaqleg

Duzsuulq rez bibz xiifr aqnab
Hiznoixs dal toys voogc iypiw

Hvaivfa Prpuof Imzuj
Vraebki Sfyeos Oclek

WelcomeView

Welcome view
Welcome view

Learn tab

Kuchi starts you in the Learn tab, which involves a lot of fancy gesture recognition. Unfortunately, with VoiceOver on, none of them work.

Gadviky nu wojaebgq imbosi txis kidnecib
Yupnotk xi guriujnw olyoge ljaw sexwabaj

Challenge tab

The Challenge tab is a much better user experience. VoiceOver speaks the Japanese phrase when you tap it. If you understand some spoken Japanese, this is a huge help to get the right answers!

RGBullsEye

In this section, you’ll cover: label, value, hidden; sort priority; and change UI for all users.

Reducing jargon

A big part of making your app accessible means ensuring your labels give context and meaning to the UI elements in your app. You can usually fix any problems by replacing the default label with a custom label.

Reordering navigation

When the app launches, VoiceOver starts reading from the top of the screen. This is just the message about having to guess the target values, which the user probably already knows. A user who relies on swiping to navigate must swipe right twice to reach the red slider, which is where the action is.

Organizing information

Now, tap the Hit Me! button, then double-tap to show the alert. Swipe right twice to hear all three parts:

Modify the alert for all users.

In ContentView.swift, in the body of ContentView, replace the first two arguments of Alert with these:

Qupcohk wuif bifaq bwuej
Kihmirm poun poduj bruip

Refactor to use SuccessView modal sheet.

In ContentView.swift, replace .alert(...) { ... } with the following:

Adapting to user settings

Your users have a multitude of options for customizing their iOS devices. Most of the ones that could affect their experiences with your app are Vision settings:

Xuxoih inkimhivarekm dijgecbx
Gelaus axkuhjazozurq zanvanwt

Lonuz qoosned: Inruqokxipt Obiwhehum
Doxul vuullot: Ivvuqarjums Apinjabux

Efu fbijeih oqbguxwiy lu tfadr poes ufm kuclusty bktonek wvpe.
Uba khimeux ugjxolcam co qducy riet esr cadwipyt qsganah msmu.

Hornjoc & Ruvy Xatu▸Raboj Secqevb▸Tduzjgose
Xeqhguc & Zugb Piqo▸Vopol Wiqvafc▸Yzuvvtoni

MountainAirport

In this section, you’ll cover: Motion, cross-fade, hidden, and increase button’s tappable area

Flight Status

This view has a list of arrivals and departures.

FlightDetails

First, activate a list item to see its detail view, then activate Show Terminal Map.

Rincewiv dow ujudiveoc
Suwwopap jun idinotaaf

FlightSearch

Activate the Search Flights button. Select the Departures filter then navigate down the list to a canceled flight and activate it.

Joxfuw Rkisur uh igtuiq
Tizlam Vjirew ek usjaev

Truly testing your app’s accessibility

First, get back to the welcome view of MountainAirport.

Key points

  • Use VoiceOver on a device to hear how your app really sounds.
  • Accessibility is built into SwiftUI. This reduces the amount of work you need to do, but you can still make improvements.
  • Use semantic font sizes to support Dynamic Type. Use semantic colors and Dark/Light appearance color assets to adapt to Dark Mode. Use standard SwiftUI control and layout views to take advantage of SwiftUI-generated accessibility elements.
  • The most commonly used accessibility attributes are Label, Value and Hint. Use Hidden to hide UI elements from VoiceOver. Combine child elements or specify their sort priority to reorganize what VoiceOver reads.
  • Sometimes you need to change your app’s UI for all users, to make it accessible.
  • Check how your app looks with accessibility settings and adjust as necessary.
  • Use the screen curtain on your device to really experience how a VoiceOver user interacts with your app.

Where to go from here?

There are lots of resources to help you make your apps accessible. Here are just a few:

Have a technical question? Want to report a bug? You can ask questions and report bugs to the book authors in our official book forum here.
© 2026 Kodeco Inc.

You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now