Как скрыть заголовок кнопки Назад при первом запуске iOS

Заголовок всё ещё отображается на первом экране, потому что, на самом деле, topItem навигационной панели при запуске — это навигационный элемент корневого контроллера, которому ещё не задали backButtonDisplayMode. Заголовок кнопки «Назад» наследуется от предыдущего контроллера, поэтому настройка, которую вы применяете в viewWillLayoutSubviews, вступает в силу только после изменения стека. Чтобы скрыть заголовок с самого первого запуска, задайте backButtonDisplayMode = .minimal до того, как кнопка «Назад» будет отрисована — либо на контроллере, который будет запушен, либо на предыдущем контроллере, который предоставляет текст кнопки.

Содержание

• Почему заголовок остаётся видимым при первом запуске
• Как корректно задать backButtonDisplayMode
• Альтернативные решения
• Итоги
• Источники

Почему заголовок остаётся видимым при первом запуске

Когда приложение запускается, стек навигационного контроллера содержит только корневой контроллер.
viewWillLayoutSubviews навигационного контроллера выполняется до того, как навигационная панель полностью выстроит свои элементы, поэтому navigationBar.topItem всё ещё указывает на навигационный элемент корневого контроллера.
backButtonDisplayMode управляет внешним видом кнопки «Назад», которая принадлежит следующему контроллеру в стеке. Поскольку на момент вызова свойства ещё нет следующего контроллера, установка параметра не влияет на кнопку, которая появится после первого push.

На последующих push’ах navigationBar.topItem меняется на новый контроллер, и присвоение в viewWillLayoutSubviews корректно скрывает заголовок.

Как корректно задать backButtonDisplayMode

1. Установить свойство в viewDidLoad каждого контроллера

class DetailViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Скрыть заголовок в кнопке «Назад» при переходе на этот VC
        navigationItem.backButtonDisplayMode = .minimal
    }
}

Почему это работает:
Когда навигационный контроллер пушит DetailViewController, панель сразу же запрашивает его navigationItem. Поскольку свойство уже установлено, кнопка «Назад» отображается только со стрелкой.

2. Установить пустой backBarButtonItem у предыдущего контроллера

class RootViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Удалить заголовок для кнопки «Назад» следующего VC
        navigationItem.backBarButtonItem = UIBarButtonItem(title: "",
                                                          style: .plain,
                                                          target: nil,
                                                          action: nil)
    }
}

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

3. Установить в viewDidAppear после первого push

class DetailViewController: UIViewController {

    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        navigationItem.backButtonDisplayMode = .minimal
    }
}

Почему это работает:
viewDidAppear вызывается после того, как навигационная панель уже отрисовала кнопку «Назад», поэтому заголовок можно убрать сразу же.

Альтернативные решения

Итоги

• Причина: На первом запуске navigationBar.topItem относится к корневому контроллеру, а свойство backButtonDisplayMode влияет только на кнопку, принадлежащую следующему контроллеру, поэтому заголовок остаётся.
• Как исправить: Задавайте backButtonDisplayMode = .minimal на контроллере, который будет отображён после корня (обычно в viewDidLoad или viewDidAppear) либо удаляйте заголовок у предыдущего контроллера через пустой backBarButtonItem.
• Проверка: После внедрения одного из подходов первая и последующие экраны будут показывать только стрелку без текста.

Ключевой совет: всегда задавайте backButtonDisplayMode в момент, когда контроллер уже добавлен в стек, либо заранее очищайте backBarButtonItem у предыдущего контроллера.

Источники

1. Apple Developer Documentation – UINavigationItem.BackButtonDisplayMode
2. Stack Overflow – “Use navigationItem.backButtonDisplayMode = .minimal with a custom back button image”
3. Stack Overflow – “iOS UINavigationBar adds title to back button”
4. Sarunw – “A new way to manage the back button title in iOS 14 with backButtonDisplayMode”