viewDidLoad в iOS: що це, призначення та приклади коду

Що таке viewDidLoad

viewDidLoad — це метод екземпляра UIViewController, який UIKit викликає відразу після того, як View контролера була завантажена в оперативну пам’ять. До цього моменту всі IBOutlet-властивості вже з’єднані з елементами інтерфейсу, але View ще не додана в ієрархію вікон і не видна користувачеві. Розробник перевизначає цей метод, щоб виконати початкове налаштування екрана.

Метод є частиною ViewController Lifecycle і слідує відразу після loadView, якщо View створюється програмно, або після завантаження з Storyboard. У типовому проекті viewDidLoad — найчастіше перевизначуваний метод UIViewController, оскільки він надає безпечну точку для роботи з subviews, які вже існують і готові до налаштування.

Важлива деталь: на момент виклику viewDidLoad розміри View ще не відповідають фінальним — Auto Layout не завершив проходів, і frame може відрізнятися від очікуваного. Для розрахунків, які залежать від розмірів, використовують viewDidLayoutSubviews.

Коли викликається viewDidLoad

Таймінг виклику viewDidLoad залежить від того, як ініціалізується контролер. У більшості випадків UIKit викликає цей метод автоматично при першому зверненні до властивості view контролера — це називається lazy-loading механізмом UIViewController.

При першому відкритті екрана

Коли NavigationController або TabBarController вперше показує ваш екран, UIKit перевіряє, чи завантажена View. Якщо ні — викликається loadView (або завантаження з Storyboard), після чого негайно спрацьовує viewDidLoad. Це стандартний сценарій, і він відбувається одноразово для кожного екземпляра контролера.

override func viewDidLoad() {
    super.viewDidLoad()
    print("View завантажено — можна налаштовувати інтерфейс")
    setupUI()
    configureTableView()
}

При поверненні на існуючий екран

viewDidLoad не викликається повторно при поверненні на екран через back button або dismiss. Якщо ваша логіка залежить від того, що екран з’являється знову — розміщуйте її в viewWillAppear. Це одна з найчастіших концептуальних помилок: розробники очікують, що viewDidLoad спрацює при кожному показі, але UIKit викликає його всього один раз.

При forcedViewLoad

Іноді розробники примусово викликають view у контролера, щоб ініціювати завантаження заздалегідь: let _ = controller.view. Це форсує виклик loadView та viewDidLoad до того, як контролер з’явиться на екрані. Такий прийом використовують, коли потрібно підготувати View заздалегідь для плавного переходу.

Що робити в viewDidLoad

viewDidLoad призначений для одноразових операцій налаштування, які не залежать від того, чи видимий екран. Правильне використання цього методу — запорука чистої архітектури та передбачуваної поведінки контролера.

Налаштування UI-компонентів

У viewDidLoad реєструють nib-файли та класи для UITableView та UICollectionView, налаштовують делегатів, задають початкові значення властивостей UI-елементів. Оскільки всі IBOutlet на цей момент уже зв’язані, можна безпечно звертатися до label.text, imageView.image та інших властивостей subviews.

override func viewDidLoad() {
    super.viewDidLoad()
    tableView.dataSource = self
    tableView.delegate = self
    tableView.register(
        CustomCell.self,
        forCellReuseIdentifier: CustomCell.identifier
    )
    title = "Головний екран"
}

Ініціалізація даних та підписки

Тут створюють viewModel, ініціалізують data source масивами, підписуються на сповіщення, які повинні діяти весь час життя контролера. Наприклад, підписка на UIApplication.willEnterForegroundNotification для оновлення даних при поверненні з фону — правильний кандидат для viewDidLoad. ViewModel у сучасній iOS-архітектурі виступає сполучною ланкою між контролером та бізнес-логікою, і її ініціалізація саме в viewDidLoad забезпечує готовність даних до моменту першої появи екрана.

Особливу увагу приділіть налаштуванню data source для таблиць і колекцій. Якщо ваша таблиця використовує UIFetchedResultsController або NSFetchedResultsController з Core Data, ініціалізуйте fetch request і делегат у viewDidLoad. Це гарантує, що при першій появі екрана таблиця вже буде заповнена даними без додаткових запитів.

Налаштування навігації

У viewDidLoad конфігурують кнопки NavigationBar, налаштовують large title, додають search controller та встановлюють кнопки edit/done. Ці елементи рідко змінюються при повторних показах екрана, тому їх ініціалізація тут оптимальна.

Чого не варто робити в viewDidLoad

Не всі операції доречні в viewDidLoad. Деякі дії, поміщені в цей метод, призводять до надмірного споживання пам’яті, неправильної поведінки або багів при повторних показах екрана.

Уникайте запуску мережевих запитів, результат яких впливає лише на UI. Якщо запит завершиться до появи екрана, користувач не побачить результат, а якщо після — дані можуть застаріти. Ініціюйте завантаження в viewDidLoad, але оновлюйте UI в viewWillAppear.

Не робіть у viewDidLoad операцій, залежних від розмірів та положення View. На момент виклику Auto Layout не завершив проходи, і frame може бути не фінальним. Для розрахунків використовуйте viewDidLayoutSubviews або перевизначте updateViewConstraints.

Не підписуйтеся на сповіщення, які діють лише коли екран видимий. Клавіатурні сповіщення, сповіщення про зміну вмісту дочірніх контролерів — підписуйтеся на них у viewWillAppear і відписуйтеся в viewDidDisappear, щоб уникнути зайвих викликів та витоків.

Не викликайте методи, які потребують видимого екрана. Наприклад, спроба показати UIAlertController з viewDidLoad призведе до помилки, оскільки View контролера ще не додана в ієрархію вікон. Будь-які UI-операції, залежні від window або presentedViewController, повинні виконуватися лише після появи екрана.

Не ініціалізуйте важкі ресурси без необхідності. Якщо на екран заходять рідко або дані відображаються не одразу, відкладіть створення ресурсоємних об’єктів до моменту, коли вони дійсно знадобляться. Lazy-ініціалізація властивостей у Swift — вбудований механізм для вирішення цього завдання: властивість із модифікатором lazy буде створена лише при першому зверненні до неї, що економить пам’ять та прискорює завантаження екрана.

Не використовуйте viewDidLoad для операцій, які повинні виконуватися при кожній появі екрана. Це найфундаментальніша помилка: початківці часто розміщують логіку оновлення даних у viewDidLoad і дивуються, що при поверненні з іншого екрана таблиця не перезавантажується. Якщо операція повинна повторюватися при кожному показі — використовуйте viewWillAppear. Якщо повинна виконатися один раз за час життя — viewDidLoad. Запам’ятайте це просте правило, щоб уникнути більшості проблем із життєвим циклом UIViewController.

Приклади коду з viewDidLoad

Розглянемо три практичних приклади, що демонструють правильне використання viewDidLoad у реальних проектах. Кожен приклад вирішує конкретне завдання налаштування екрана.

Приклад 1: налаштування колекції з кастомними комірками

override func viewDidLoad() {
    super.viewDidLoad()
    collectionView.register(
        PhotoCell.self,
        forCellWithReuseIdentifier: PhotoCell.reuseId
    )
    collectionView.register(
        HeaderView.self,
        forSupplementaryViewOfKind: UICollectionView.elementKindSectionHeader,
        withReuseIdentifier: HeaderView.reuseId
    )
    viewModel.delegate = self
    viewModel.fetchInitialPage()
}

Приклад 2: налаштування констрейнтів програмно

override func viewDidLoad() {
    super.viewDidLoad()
    let label = UILabel()
    label.text = "Привіт, світе!"
    label.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(label)

    NSLayoutConstraint.activate([
        label.centerXAnchor.constraint(equalTo: view.centerXAnchor),
        label.centerYAnchor.constraint(equalTo: view.centerYAnchor)
    ])
}

Приклад 3: налаштування пустого стану та лоадера

У viewDidLoad також налаштовують елементи, що відображаються за відсутності даних: пустий стан, лоадер, placeholder. Ці компоненти створюються один раз і перевикористовуються при кожній появі екрана. Приховування або показ цих елементів керується в viewWillAppear залежно від актуальних даних.

override func viewDidLoad() {
    super.viewDidLoad()
    emptyStateLabel = UILabel()
    emptyStateLabel.text = "Немає даних"
    emptyStateLabel.textAlignment = .center
    emptyStateLabel.isHidden = true
    view.addSubview(emptyStateLabel)

    activityIndicator = UIActivityIndicatorView(style: .medium)
    activityIndicator.hidesWhenStopped = true
    view.addSubview(activityIndicator)
}

Приклад 4: підписка на сповіщення додатка

override func viewDidLoad() {
    super.viewDidLoad()
    NotificationCenter.default.addObserver(
        self,
        selector: #selector(handleEnterForeground),
        name: UIApplication.willEnterForegroundNotification,
        object: nil
    )
}

@objc private func handleEnterForeground() {
    refreshContent()
}