Какой метод используется в UINavigationController для показа следующего экрана?

Основной метод для навигации

В UINavigationController для показа следующего экрана основным и наиболее часто используемым методом является:

func pushViewController(_ viewController: UIViewController, animated: Bool)

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

Базовый пример использования

// Создаем следующий экран
let nextViewController = DetailViewController()
    
// Выполняем переход
navigationController?.pushViewController(nextViewController, animated: true)

Ключевые особенности push-навигации

Стек навигации — фундаментальная концепция, на которой построена работа UINavigationController:

• Каждый новый контроллер помещается на вершину стека
• При возврате (pop) контроллер удаляется из стека
• Стек сохраняет историю переходов, позволяя возвращаться назад
• Метод pushViewController непосредственно управляет этим стеком

Жизненный цикл при push-переходе

При вызове pushViewController происходит следующее:

// Пример с обработкой жизненного цикла
let detailVC = DetailViewController()

// 1. Текущий контроллер получает уведомления (willMove, viewWillDisappear)
// 2. Новый контроллер добавляется в иерархию
// 3. Выполняется анимированный переход
navigationController?.pushViewController(detailVC, animated: true)

// 4. После завершения анимации:
//    - Новый контроллер получает viewDidAppear
//    - Предыдущий получает viewDidDisappear

Альтернативные методы и связанный функционал

1. Обратный переход (pop)

Для возврата на предыдущий экран используются методы:

// Вернуться на один шаг назад
popViewController(animated: Bool)

// Вернуться к конкретному контроллеру в стеке
popToViewController(_ viewController: UIViewController, animated: Bool)

// Вернуться к корневому контроллеру
popToRootViewController(animated: Bool)

2. Замена текущего стека

// Полная замена всех контроллеров в стеке
setViewControllers(_ viewControllers: [UIViewController], animated: Bool)

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

3. Модификация без анимации

// Добавление без анимации (для начальной настройки)
navigationController?.setViewControllers([rootVC, secondVC], animated: false)

// Push без анимации
navigationController?.pushViewController(nextVC, animated: false)

Важные практические аспекты

Управление потоком данных

// Рекомендуемый подход - передача данных через инициализатор
class DetailViewController: UIViewController {
    private let item: DataItem
    
    init(item: DataItem) {
        self.item = item
        super.init(nibName: nil, bundle: nil)
    }
    
    // ... или через свойство с проверкой
    var detailItem: Item? {
        didSet {
            configureView()
        }
    }
}

// Использование
let detailVC = DetailViewController(item: selectedItem)
navigationController?.pushViewController(detailVC, animated: true)

Обработка повторных нажатий

// Защита от множественных быстрых нажатий
private var isPushing = false

func showNextScreen() {
    guard !isPushing else { return }
    isPushing = true
    
    let nextVC = NextViewController()
    navigationController?.pushViewController(nextVC, animated: true)
    
    // Сброс флага с задержкой
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
        self.isPushing = false
    }
}

Современные подходы (iOS 13+)

С появлением SwiftUI и UINavigationController в UIKit появились новые возможности:

1. NavigationController с обертки SwiftUI

// SwiftUI интеграция
struct ContentView: View {
    var body: some View {
        NavigationView {
            List(items) { item in
                NavigationLink(destination: DetailView(item: item)) {
                    Text(item.title)
                }
            }
        }
    }
}

2. UINavigationControllerDelegate

Для кастомной анимации и контроля над навигацией:

class CustomNavigationDelegate: NSObject, UINavigationControllerDelegate {
    func navigationController(_ navigationController: UINavigationController, 
                              animationControllerFor operation: UINavigationController.Operation,
                              from fromVC: UIViewController,
                              to toVC: UIViewController) -> UIViewControllerAnimatedTransitioning? {
        // Возвращаем кастомную анимацию
        return CustomTransitionAnimator()
    }
}

Заключение

Метод pushViewController остается краеугольным камнем навигации в iOS-приложениях на UIKit. Несмотря на появление SwiftUI и новых паттернов, понимание его работы, жизненного цикла и связанных методов критически важно для создания плавной и предсказуемой навигации. Ключевые моменты для запоминания: работа со стеком контроллеров, правильная передача данных между экранами и учет состояния анимации при обработке пользовательских взаимодействий.