Вырез не нужно измерять самостоятельно. iOS уже вычисляет безопасную область конкретного окна и контейнера. Если заголовок или кнопка перекрыты, обычно контент закреплён к верхнему краю экрана либо весь корневой view получил `ignoresSafeArea`, хотя до краёв должен доходить только фон.

Исправление состоит из двух слоёв: декоративный цвет или изображение может занимать весь экран, а текст, кнопки, списки и жестовые зоны располагаются внутри safe area. Такая схема переживает Dynamic Island, поворот, системные панели и будущие размеры устройства без таблицы моделей.

Сначала найдите слой, который нарушил границу

СимптомЧастая причинаИсправление
заголовок под вырезомconstraint к view.topAnchorsafeAreaLayoutGuide.topAnchor
кнопка у Home indicatorconstraint к bottomAnchorsafe area bottom или safeAreaInset
фон обрывается сверхуфон тоже ограничен safe areaрастянуть только background
ломается в landscapeфиксированный paddingадаптивные constraints/layout
ломается с крупным шрифтомфиксированная высотаDynamic Type и перенос строк

Отладочный overlay полезнее названия модели: подсветите frame контейнера и его safe area. В navigation, sheet, split view и embedded controller значения могут отличаться даже на одном телефоне.

SwiftUI: фон до краёв, содержимое по умолчанию безопасно

ZStack {
    Color.indigo.ignoresSafeArea()

    VStack(spacing: 16) {
        Text("Профиль").font(.title)
        FormContent()
        Button("Сохранить", action: save)
    }
    .padding(.horizontal, 20)
}
.safeAreaInset(edge: .bottom) {
    StatusBarView()
}

`ignoresSafeArea()` оставлен у цвета, а не у всего `VStack`. `safeAreaInset` резервирует место для нижнего элемента и меняет доступную область соседнего содержимого; простой overlay способен закрыть последние строки списка. Если inset не нужен, сохраняйте стандартное поведение SwiftUI.

UIKit: constraints идут к safeAreaLayoutGuide

let guide = view.safeAreaLayoutGuide
NSLayoutConstraint.activate([
    title.topAnchor.constraint(equalTo: guide.topAnchor, constant: 16),
    title.leadingAnchor.constraint(equalTo: guide.leadingAnchor, constant: 20),
    action.bottomAnchor.constraint(equalTo: guide.bottomAnchor, constant: -12),
    action.trailingAnchor.constraint(equalTo: guide.trailingAnchor, constant: -20)
])

Для Auto Layout используйте layout guide. `safeAreaInsets` нужны, когда позиция рассчитывается вручную; читать их корректно после layout и реагировать на изменение области, а не один раз в `viewDidLoad`. Дополнительные отступы задают поверх системной области только по реальной дизайнерской причине.

Клавиатура и вырез — две разные границы

Safe area защищает от системных областей дисплея, но не решает автоматически все сценарии клавиатуры. Поле ввода должно оставаться видимым через keyboard layout guide, scroll view insets или штатные механизмы выбранного UI-фреймворка. Не прибавляйте высоту клавиатуры одновременно в двух местах: получится двойной отступ.

  • Safe area — вырез, системные бары и домашний индикатор в текущем контейнере.
  • Layout margins — внутренний ритм интерфейса, а не форма экрана.
  • Keyboard guide/inset — доступная область при вводе.
  • Dynamic Type — рост текста и перенос, из-за которого фиксированная высота становится опасной.

Не распознавайте iPhone по имени модели

Проверка `if model == ...` устаревает при новом устройстве, не учитывает zoom/ориентацию и плохо работает в контейнерах. Точно так же ненадёжен глобальный статус-бар height. Компонент должен получать геометрию из своего окружения и строиться от неё. Исключение для иммерсивного медиа документируйте локально, не отключая safe area у всего приложения.

Матрица проверки помещается в один прогон

  1. Открыть экран на устройстве с Dynamic Island в portrait и landscape.
  2. Повторить на компактном iPhone и симуляторе без такого выреза.
  3. Включить самый крупный доступный Dynamic Type и жирный текст.
  4. Показать клавиатуру, сменить фокус между первым и последним полем.
  5. Открыть экран как sheet и внутри navigation container.
  6. Проверить скриншот: фон доходит до краёв, интерактивные элементы не пересекают safe area.
  7. В Accessibility Inspector проверить доступность кнопок и порядок фокуса.

Для разбора приложите скриншот с включённой подсветкой safe area, дерево контейнеров, constraints либо минимальный SwiftUI view, ориентацию и размер текста. UDID, персональные данные и полный проект не нужны. Если баг исчезает после удаления общего `ignoresSafeArea`, переносите это правило на конкретный фон.

Проверенные источники