Что входит в доступность iOS-приложения: для каких пользователей вы его делаете и какие системные функции поддерживаете?

Это значит, что приложением может пользоваться человек, который не видит экран, нуждается в крупном тексте, не различает цвета, плохо переносит анимацию или не может точно попадать пальцем.

Что такое accessibility label, value, traits и hint у элемента и в каком порядке VoiceOver их читает?

VoiceOver читает label, value, traits, hint: label говорит, что это за элемент, value передаёт его текущее состояние, traits описывают, какого он типа и как себя ведёт, а hint сообщает, что произойдёт при активации.

Что произносит VoiceOver, проходя по этой строке свайпами, и что бы вы изменили?

Три остановки, две из них создают шум: имя ассета заглушки как картинка, имя пользователя и имя ассета корзины как кнопка.

Что такое Dynamic Type и как поддержать его в SwiftUI и UIKit?

Dynamic Type представляет собой системную настройку размера текста; текст, заданный текстовым стилем вроде `.body` или `.headline`, масштабируется вместе с ней автоматически: через семь обычных размеров и пять увеличенных размеров для доступности.

Как локализовать iOS-приложение и что нельзя хардкодить?

Добавьте языки в проект, держите каждую строку для пользователя в String Catalog (`Localizable.xcstrings`), который Xcode наполняет из кода при каждой сборке, и позвольте локали пользователя форматировать числа, даты и цены.

Карточка товара состоит из пяти остановок VoiceOver: картинка, название, цена, бейдж, кнопка-сердечко. Как сделать одну, и когда этого делать не стоит?

Оберните карточку в `.accessibilityElement(children: .combine)`, чтобы она стала одним элементом с объединённым label, а сердечко отдайте как именованное кастомное действие; в UIKit поставьте контейнеру `isAccessibilityElement = true` и напишите ему label.

VoiceOver читает цену карточки раньше названия, хотя название нарисовано выше. Как управлять порядком чтения?

В SwiftUI сгруппируйте вью через `.accessibilityElement(children: .contain)` и упорядочьте их через `.accessibilitySortPriority` (чем больше, тем раньше читается); в UIKit задайте контейнеру массив `accessibilityElements` в нужном порядке.

В строке есть swipe-to-delete и кастомный регулятор громкости. Как пользователь VoiceOver доберётся до них без этих жестов?

У каждого жеста должен быть аналог в доступности: кастомные действия (`.accessibilityAction(named:)`, `accessibilityCustomActions`) появляются на роторе Actions в VoiceOver, а контрол со значением становится adjustable, чтобы свайпы вверх и вниз его меняли.

После сохранения VoiceOver прыгает в начало экрана и читает его заново. Какое уведомление отправили по ошибке и какое нужно было?

Он отправил `.screenChanged`: это сообщает VoiceOver, что появился новый экран, и переносит фокус на его первый элемент; статусное сообщение должно быть `.announcement`, которое произносится без перемещения фокуса.

Форма не прошла валидацию. Как в SwiftUI перевести фокус VoiceOver на сообщение об ошибке?

Повесьте `.accessibilityFocused(_:)` на вью с ошибкой, привяжите его к свойству `@AccessibilityFocusState` и выставьте это свойство, когда ошибка уже на экране; VoiceOver переведёт курсор туда и прочитает её.

QA сообщает, что эта строка игнорирует размер текста пользователя, а когда начинает масштабироваться, обрезается на самых крупных размерах. Что вы измените?

Используйте текстовый стиль, чтобы текст масштабировался, и уберите вокруг него все фиксированные размеры: `minHeight` вместо `height`, размер иконки через `@ScaledMetric`, без ограничения в одну строку и с вертикальной раскладкой на размерах для доступности.

Что такое Reduce Motion, Reduce Transparency, Increase Contrast и Bold Text и как учитывать их в своём UI?

Это системные настройки доступности, которые UIKit и SwiftUI учитывают в своих контролах; для собственных анимаций, размытий, цветов и шрифтов вы читаете их (как значения окружения SwiftUI или флаги `UIAccessibility`) и подстраиваетесь.

Дизайн помечает оплаченные заказы зелёной точкой, а просроченные красной. Что с этим не так и как это исправить?

Смысл передаётся только цветом, поэтому статус теряется для людей с нарушением цветовосприятия, а для VoiceOver теряется полностью; добавьте второй сигнал (форму или слово) и вынесите статус в accessibility label или value.

Как тестировать доступность приложения: что находят Accessibility Inspector и performAccessibilityAudit(), а что они пропускают?

Автоматические аудиты ловят механические проблемы одного экрана (отсутствующие labels, маленькие зоны нажатия, низкий контраст, обрезанный текст), а понять, есть ли в labels смысл и можно ли довести задачу до конца, может только человек с VoiceOver.

Что такое String Catalog и что значат состояния New, Needs Review и Stale после сборки?

String Catalog (`.xcstrings`) представляет собой JSON-файл, который Xcode синхронизирует с кодом: каждая сборка извлекает в него локализуемые литералы и отслеживает состояние каждого перевода, а в бандл он компилируется в обычные файлы `.strings` и `.stringsdict`.

Строка задана как "\(count) items", а в русской сборке выходит «1 товаров». Как правильно работать с множественным числом?

Через вариацию по числу (plural variation) в String Catalog: система выбирает для числа категорию множественного числа по CLDR, а каждый язык даёт свои формы, так что ваш код никогда не выбирает между единственным и множественным.

В немецкой сборке заголовок навигации переведён, а заголовки секций остались английскими. Почему и какой тип это исправляет?

`Text` локализует только литералы: `Text(section.title)` со `String` использует дословный инициализатор, а «Recent», сохранённое как `String`, так и не было извлечено.

Как форматировать даты, числа и цены для пользователя и кто выбирает формат, если язык английский, а регион немецкий?

Используйте API `.formatted()` и дайте решать `Locale.current`.

Продукт хочет переключатель языка внутри приложения: что уже даёт iOS и почему запись AppleLanguages в UserDefaults считается хаком?

С iOS 13 в системе есть язык для отдельного приложения: если приложение поставляется с несколькими локализациями, на его странице в Настройках появляется пункт «Язык», а «переключатель» в приложении должен просто открывать эту страницу через `UIApplication.openSettingsURLString`.

Как поддержать языки с письмом справа налево, например арабский: что зеркалится автоматически, что переворачивать самому и что нельзя зеркалить никогда?

При вёрстке через leading и trailing UIKit и SwiftUI зеркалят интерфейс автоматически; вы решаете для каждой картинки, направленная ли она, оставляете незеркальными медиаконтролы и логотипы, а порядок символов в тексте доверяете алгоритму двунаправленного текста Unicode (bidi).

Столбчатый график нарисован в одном Canvas или в переопределённом draw(_:). Как сделать каждый столбец доступным для VoiceOver?

Нарисованный график остаётся одним непрозрачным элементом, поэтому дерево доступности для него строится вручную: `.accessibilityChildren` в SwiftUI или `UIAccessibilityElement` с фреймами в UIKit, плюс сводка и, в идеале, дескриптор графика для Audio Graphs.

Переводы приходят за две недели до релиза. Как поймать обрезанный текст и захардкоженные строки в CI задолго до этого?

Гоняйте UI-тесты на псевдоязыках Xcode и на самом крупном размере текста: они растягивают, снабжают диакритикой и берут в скобки каждую локализованную строку, так что обрезка, склеенные предложения и неизвлечённые литералы видны без всякого переводчика.

Помимо UI приложения, где локализуются страница в App Store, push-уведомления и App Shortcuts?

Всё это живёт вне кода вью: описание в магазине лежит в App Store Connect, текст пуша приходит как `loc-key`, который резолвится на устройстве или в Notification Service Extension, а фразы App Shortcuts хранятся в отдельном `AppShortcuts.xcstrings`.

Irbisa · Шпаргалка

Доступность и локализация

VoiceOver, traits, Dynamic Type, Reduce Motion, String Catalog, плюрализация, RTL, форматы локали

Middle-разработчик · 25 вопросов

01
Что входит в доступность iOS-приложения: для каких пользователей вы его делаете и какие системные функции поддерживаете?
Это значит, что приложением может пользоваться человек, который не видит экран, нуждается в крупном тексте, не различает цвета, плохо переносит анимацию или не может точно попадать пальцем.
02
Что такое accessibility label, value, traits и hint у элемента и в каком порядке VoiceOver их читает?
VoiceOver читает label, value, traits, hint: label говорит, что это за элемент, value передаёт его текущее состояние, traits описывают, какого он типа и как себя ведёт, а hint сообщает, что произойдёт при активации.
```
// wrong: type and state are baked into the labelButton(action: toggle) { Image(systemName: icon) }  .accessibilityLabel(isOn ? "Favourite button, on" : "Favourite button, off") // right: each piece in its own propertyButton(action: toggle) { Image(systemName: icon) }…
```
03
Что произносит VoiceOver, проходя по этой строке свайпами, и что бы вы изменили?
```
struct UserRow: View {  let user: User  let onDelete: () -> Void   var body: some View {    HStack {      Image("avatar_placeholder")      Text(user.name)      Spacer()      Button(action: onDelete) {        Image("ic_trash")      }    }  }}
```
Три остановки, две из них создают шум: имя ассета заглушки как картинка, имя пользователя и имя ассета корзины как кнопка.
04
Что такое Dynamic Type и как поддержать его в SwiftUI и UIKit?
Dynamic Type представляет собой системную настройку размера текста; текст, заданный текстовым стилем вроде .body или .headline, масштабируется вместе с ней автоматически: через семь обычных размеров и пять увеличенных размеров для доступности.
```
// SwiftUIText("Order history").font(.headline)            // scalesText(order.note)  .font(.custom("Brand", size: 15, relativeTo: .subheadline))Text("v2.4.1").font(.system(size: 11))           // fixed: never scales…
```
05
Как локализовать iOS-приложение и что нельзя хардкодить?
Добавьте языки в проект, держите каждую строку для пользователя в String Catalog (Localizable.xcstrings), который Xcode наполняет из кода при каждой сборке, и позвольте локали пользователя форматировать числа, даты и цены.
```
// SwiftUI: literals are localization keysText("Order history")Button("Delete", role: .destructive) { delete() } // Outside a view: resolve now, and give the translator contextlet title = String(localized: "Delete order?",…
```
06
Карточка товара состоит из пяти остановок VoiceOver: картинка, название, цена, бейдж, кнопка-сердечко. Как сделать одну, и когда этого делать не стоит?
Оберните карточку в .accessibilityElement(children: .combine), чтобы она стала одним элементом с объединённым label, а сердечко отдайте как именованное кастомное действие; в UIKit поставьте контейнеру isAccessibilityElement = true и напишите ему label.
```
HStack {  AsyncImage(url: product.imageURL)    .accessibilityHidden(true)             // decoration: hide before combining  VStack(alignment: .leading) {    Text(product.name)    Text(product.price.formatted(.currency(code: product.currency)))…
```
07
VoiceOver читает цену карточки раньше названия, хотя название нарисовано выше. Как управлять порядком чтения?
В SwiftUI сгруппируйте вью через .accessibilityElement(children: .contain) и упорядочьте их через .accessibilitySortPriority (чем больше, тем раньше читается); в UIKit задайте контейнеру массив accessibilityElements в нужном порядке.
```
// SwiftUI: price is declared first but drawn below the title; the title must be read firstZStack(alignment: .topLeading) {  Text(album.price)    .offset(y: 24)    .accessibilitySortPriority(1)  Text(album.title)…
```
08
В строке есть swipe-to-delete и кастомный регулятор громкости. Как пользователь VoiceOver доберётся до них без этих жестов?
У каждого жеста должен быть аналог в доступности: кастомные действия (.accessibilityAction(named:), accessibilityCustomActions) появляются на роторе Actions в VoiceOver, а контрол со значением становится adjustable, чтобы свайпы вверх и вниз его меняли.
```
MessageRow(message: message)  .accessibilityAction(named: "Delete") { delete(message) }  .accessibilityAction(named: "Mark as read") { markRead(message) } VolumeDial(value: $volume)  .accessibilityLabel("Volume")…
```
09
После сохранения VoiceOver прыгает в начало экрана и читает его заново. Какое уведомление отправили по ошибке и какое нужно было?
Он отправил .screenChanged: это сообщает VoiceOver, что появился новый экран, и переносит фокус на его первый элемент; статусное сообщение должно быть .announcement, которое произносится без перемещения фокуса.
```
// wrong: resets the user's position and re-reads the screenUIAccessibility.post(notification: .screenChanged, argument: "Saved") // right: speak, and leave focus aloneUIAccessibility.post(notification: .announcement,                     argument: String(localized: "Draft saved"))…
```
10
Форма не прошла валидацию. Как в SwiftUI перевести фокус VoiceOver на сообщение об ошибке?
Повесьте .accessibilityFocused(_:) на вью с ошибкой, привяжите его к свойству @AccessibilityFocusState и выставьте это свойство, когда ошибка уже на экране; VoiceOver переведёт курсор туда и прочитает её.
```
struct SignUpForm: View {  @State private var email = ""  @State private var error: String?  @AccessibilityFocusState private var errorFocused: Bool   var body: some View {…
```
11
QA сообщает, что эта строка игнорирует размер текста пользователя, а когда начинает масштабироваться, обрезается на самых крупных размерах. Что вы измените?
```
HStack(spacing: 12) {  Image(systemName: "envelope")    .frame(width: 40, height: 40)  Text(item.title)    .font(.system(size: 17))    .lineLimit(1)}.frame(height: 44)
```
Используйте текстовый стиль, чтобы текст масштабировался, и уберите вокруг него все фиксированные размеры: minHeight вместо height, размер иконки через @ScaledMetric, без ограничения в одну строку и с вертикальной раскладкой на размерах для доступности.

Найдите баг: пользователь увеличивает размер текста через Пункт управления, и подписи в этой шапке растут, но остаются в ряд и обрезаются, пока экран не открыть заново.

final class ContactHeaderViewController: UIViewController {  private let stack = UIStackView(arrangedSubviews: [UILabel(), UILabel()])  override func viewDidLoad() {    super.viewDidLoad()    for case let label as UILabel in stack.arrangedSubviews {      label.font = .preferredFont(forTextStyle: .body)      label.adjustsFontForContentSizeCategory = true    }    view.addSubview(stack)    stack.frame = view.bounds  }  override func viewWillAppear(_ animated: Bool) {    super.viewWillAppear(animated)    stack.axis = traitCollection.preferredContentSizeCategory.isAccessibilityCategory      ? .vertical : .horizontal  }}

Ось выбирается только во viewWillAppear, который не вызывается, когда размер текста меняется при открытом экране: подписи следуют за Dynamic Type сразу, а стек остаётся горизонтальным, и крупный текст обрезается.

13
Что такое Reduce Motion, Reduce Transparency, Increase Contrast и Bold Text и как учитывать их в своём UI?
Это системные настройки доступности, которые UIKit и SwiftUI учитывают в своих контролах; для собственных анимаций, размытий, цветов и шрифтов вы читаете их (как значения окружения SwiftUI или флаги UIAccessibility) и подстраиваетесь.
```
struct Hero: View {  let isOpen: Bool  let parallaxOffset: CGFloat  @Environment(\.accessibilityReduceMotion) private var reduceMotion  @Environment(\.accessibilityReduceTransparency) private var reduceTransparency  @Environment(\.colorSchemeContrast) private var contrast…
```
14
Дизайн помечает оплаченные заказы зелёной точкой, а просроченные красной. Что с этим не так и как это исправить?
Смысл передаётся только цветом, поэтому статус теряется для людей с нарушением цветовосприятия, а для VoiceOver теряется полностью; добавьте второй сигнал (форму или слово) и вынесите статус в accessibility label или value.
```
struct OrderRow: View {  let order: Order   var body: some View {    HStack {      Image(systemName: order.isPaid ? "checkmark.circle.fill"…
```
15
Как тестировать доступность приложения: что находят Accessibility Inspector и performAccessibilityAudit(), а что они пропускают?
Автоматические аудиты ловят механические проблемы одного экрана (отсутствующие labels, маленькие зоны нажатия, низкий контраст, обрезанный текст), а понять, есть ли в labels смысл и можно ли довести задачу до конца, может только человек с VoiceOver.
```
final class AccessibilityAuditTests: XCTestCase {  func testHomeScreenPassesAudit() throws {    let app = XCUIApplication()    app.launch()     try app.performAccessibilityAudit(for: [.contrast, .hitRegion, .textClipped]) { issue in…
```
16
Что такое String Catalog и что значат состояния New, Needs Review и Stale после сборки?
String Catalog (.xcstrings) представляет собой JSON-файл, который Xcode синхронизирует с кодом: каждая сборка извлекает в него локализуемые литералы и отслеживает состояние каждого перевода, а в бандл он компилируется в обычные файлы .strings и .stringsdict.
17
Строка задана как "\(count) items", а в русской сборке выходит «1 товаров». Как правильно работать с множественным числом?
Через вариацию по числу (plural variation) в String Catalog: система выбирает для числа категорию множественного числа по CLDR, а каждый язык даёт свои формы, так что ваш код никогда не выбирает между единственным и множественным.
```
// wrong: an English-only rule baked into the call sitelet label = count == 1 ? "1 item" : "\(count) items" // right: one key, every language brings its own formsText("\(count) items")              // catalog key: "%lld items"…
```
18
В немецкой сборке заголовок навигации переведён, а заголовки секций остались английскими. Почему и какой тип это исправляет?
```
struct LibrarySection: Identifiable {  let id = UUID()  let title: String} let sections = [LibrarySection(title: "Recent"),                LibrarySection(title: "Favourites")] List(sections) { section in  Text(section.title)}.navigationTitle("Library")
```
Text локализует только литералы: Text(section.title) со String использует дословный инициализатор, а «Recent», сохранённое как String, так и не было извлечено.
19
Как форматировать даты, числа и цены для пользователя и кто выбирает формат, если язык английский, а регион немецкий?
Используйте API .formatted() и дайте решать Locale.current.
```
// wrong: the developer chose the pattern and the symbollet df = DateFormatter()df.dateFormat = "MM/dd/yyyy hh:mm a"Text("$\(order.total)") // right: the locale decides presentation, the data decides the currency…
```

Найдите баг: во французской и немецкой сборках пикера стран несколько стран оказываются в самом конце списка.

struct CountryPicker: View {  let regionCodes: [String]            // "AE", "AT", "DE", "ZW", …  @Binding var selection: String   private var countries: [(code: String, name: String)] {    regionCodes      .map { ($0, Locale.current.localizedString(forRegionCode: $0) ?? $0) }      .sorted { $0.name < $1.name }  }   var body: some View {    Picker("Country", selection: $selection) {      ForEach(countries, id: \.code) { Text(verbatim: $0.name).tag($0.code) }    }  }}

< у String сравнивает кодовые точки Unicode, а не алфавит пользователя, поэтому названия на букву с диакритикой (Égypte, Österreich) уходят после Z, а строчные идут после заглавных.

21
Продукт хочет переключатель языка внутри приложения: что уже даёт iOS и почему запись AppleLanguages в UserDefaults считается хаком?
С iOS 13 в системе есть язык для отдельного приложения: если приложение поставляется с несколькими локализациями, на его странице в Настройках появляется пункт «Язык», а «переключатель» в приложении должен просто открывать эту страницу через UIApplication.openSettingsURLString.
22
Как поддержать языки с письмом справа налево, например арабский: что зеркалится автоматически, что переворачивать самому и что нельзя зеркалить никогда?
При вёрстке через leading и trailing UIKit и SwiftUI зеркалят интерфейс автоматически; вы решаете для каждой картинки, направленная ли она, оставляете незеркальными медиаконтролы и логотипы, а порядок символов в тексте доверяете алгоритму двунаправленного текста Unicode (bidi).
```
// A directional custom icon: mirror it in RTLImage("arrow_next")  .flipsForRightToLeftLayoutDirection(true) // Media controls keep their direction in a mirrored screenPlayerControls()…
```
23
Столбчатый график нарисован в одном Canvas или в переопределённом draw(_:). Как сделать каждый столбец доступным для VoiceOver?
Нарисованный график остаётся одним непрозрачным элементом, поэтому дерево доступности для него строится вручную: .accessibilityChildren в SwiftUI или UIAccessibilityElement с фреймами в UIKit, плюс сводка и, в идеале, дескриптор графика для Audio Graphs.
```
struct SalesChart: View {  let sales: [MonthlySales]          // Identifiable: month, amount  var body: some View {    Canvas { context, size in drawBars(sales, in: context, size: size) }      .accessibilityLabel("Sales by month")      .accessibilityChildren {        // never drawn, only exposed to VoiceOver…
```
24
Переводы приходят за две недели до релиза. Как поймать обрезанный текст и захардкоженные строки в CI задолго до этого?
Гоняйте UI-тесты на псевдоязыках Xcode и на самом крупном размере текста: они растягивают, снабжают диакритикой и берут в скобки каждую локализованную строку, так что обрезка, склеенные предложения и неизвлечённые литералы видны без всякого переводчика.
```
final class LocalizationLayoutTests: XCTestCase {  func testCheckoutFitsLongStringsAndLargeText() throws {    let app = XCUIApplication()    // Language and region come from the test plan configuration    app.launchArguments += [      "-UIPreferredContentSizeCategoryName", "UICTContentSizeCategoryAccessibilityXXXL",…
```
25
Помимо UI приложения, где локализуются страница в App Store, push-уведомления и App Shortcuts?
Всё это живёт вне кода вью: описание в магазине лежит в App Store Connect, текст пуша приходит как loc-key, который резолвится на устройстве или в Notification Service Extension, а фразы App Shortcuts хранятся в отдельном AppShortcuts.xcstrings.