viewDidLoad v iOS: co to je, účel a příklady kódu

Co je viewDidLoad

viewDidLoad — je instanční metoda UIViewController, kterou UIKit zavolá ihned po načtení View controlleru do paměti RAM. V tomto okamžiku jsou všechny vlastnosti IBOutlet již propojeny s prvky rozhraní, ale View ještě nebyla přidána do hierarchie oken a není pro uživatele viditelná. Vývojář tuto metodu přepisuje, aby provedl počáteční konfiguraci obrazovky.

Metoda je součástí ViewController Lifecycle a následuje bezprostředně po loadView, pokud je View vytvářena programově, nebo po načtení z Storyboard. V typickém projektu je viewDidLoad nejčastěji přepisovanou metodou UIViewController, protože poskytuje bezpečný bod pro práci s subviews, které již existují a jsou připraveny ke konfiguraci.

Důležitý detail: v okamžiku volání viewDidLoad rozměry View ještě neodpovídají konečným — Auto Layout nedokončil průchody a frame se může lišit od očekávaného. Pro výpočty závislé na rozměrech se používá viewDidLayoutSubviews.

Kdy se volá viewDidLoad

Načasování volání viewDidLoad závisí na tom, jak je controller inicializován. Ve většině případů UIKit volá tuto metodu automaticky při prvním přístupu k vlastnosti view controlleru — nazývá se to mechanismus lazy-loading UIViewController.

Při prvním otevření obrazovky

Když NavigationController nebo TabBarController poprvé zobrazí vaši obrazovku, UIKit zkontroluje, zda je View načtena. Pokud ne — zavolá se loadView (nebo načtení ze Storyboard), po čemž okamžitě následuje viewDidLoad. Toto je standardní scénář a nastává jednou pro každou instanci controlleru.

override func viewDidLoad() {
    super.viewDidLoad()
    print("View načtena — lze nastavit rozhraní")
    setupUI()
    configureTableView()
}

Při návratu na existující obrazovku

viewDidLoad se nevolá znovu při návratu na obrazovku pomocí back button nebo dismiss. Pokud vaše logika závisí na tom, že se obrazovka znovu objeví — umístěte ji do viewWillAppear. Toto je jedna z nejčastějších koncepčních chyb: vývojáři očekávají, že viewDidLoad se spustí při každém zobrazení, ale UIKit jej volá pouze jednou.

Při forcedViewLoad

Někdy vývojáři vynucují volání view controlleru, aby spustili načítání předem: let _ = controller.view. Toto vynutí volání loadView a viewDidLoad před tím, než se controller objeví na obrazovce. Tento trik se používá, když je třeba připravit View předem pro plynulý přechod.

Co se dělá v viewDidLoad

viewDidLoad je určen pro jednorázové konfigurační operace, které nezávisí na tom, zda je obrazovka viditelná. Správné použití této metody je klíčem k čisté architektuře a předvídatelnému chování controlleru.

Nastavení UI komponent

V viewDidLoad se registrují nib soubory a třídy pro UITableView a UICollectionView, nastavují se delegáti a určují se počáteční hodnoty vlastností UI prvků. Protože všechna IBOutlet jsou v tomto okamžiku již propojena, lze bezpečně přistupovat k label.text, imageView.image a dalším vlastnostem subviews.

override func viewDidLoad() {
    super.viewDidLoad()
    tableView.dataSource = self
    tableView.delegate = self
    tableView.register(
        CustomCell.self,
        forCellReuseIdentifier: CustomCell.identifier
    )
    title = "Hlavní obrazovka"
}

Inicializace dat a odběry

Zde se vytváří viewModel, inicializuje se data source pomocí polí a přihlašuje se k oznámením, která mají fungovat po celou dobu života controlleru. Například přihlášení k UIApplication.willEnterForegroundNotification pro aktualizaci dat při návratu z pozadí — vhodný kandidát pro viewDidLoad. ViewModel v moderní iOS architektuře slouží jako spojovací článek mezi controllerem a obchodní logikou a jeho inicializace právě v viewDidLoad zajišťuje připravenost dat v okamžiku prvního zobrazení obrazovky.

Věnujte zvláštní pozornost nastavení data source pro tabulky a kolekce. Pokud vaše tabulka používá UIFetchedResultsController nebo NSFetchedResultsController s Core Data, inicializujte fetch request a delegáta v viewDidLoad. To zaručuje, že při prvním zobrazení obrazovky bude tabulka již naplněna daty bez dodatečných dotazů.

Nastavení navigace

V viewDidLoad se konfigurují tlačítka NavigationBar, nastavuje se large title, přidává se search controller a nastavují se tlačítka edit/done. Tyto prvky se při opakovaném zobrazení obrazovky mění zřídka, takže jejich inicializace zde je optimální.

Co nedělat v viewDidLoad

Ne všechny operace jsou vhodné pro viewDidLoad. Některé akce umístěné v této metodě vedou k nadměrné spotřebě paměti, nesprávnému chování nebo chybám při opakovaném zobrazení obrazovky.

Vyhněte se spouštění síťových požadavků, jejichž výsledek ovlivňuje pouze UI. Pokud požadavek skončí před zobrazením obrazovky, uživatel neuvidí výsledek, a pokud po — data mohou být zastaralá. Spusťte načítání v viewDidLoad, ale aktualizujte UI v viewWillAppear.

Neprovádějte v viewDidLoad operace závislé na rozměrech a poloze View. V okamžiku volání Auto Layout nedokončil průchody a frame nemusí být konečný. Pro výpočty používejte viewDidLayoutSubviews nebo přepište updateViewConstraints.

Nepřihlašujte se k oznámením, která fungují pouze když je obrazovka viditelná. Oznámení o klávesnici, oznámení o změně obsahu podřízených controllerů — přihlaste se k nim v viewWillAppear a odhlaste se v viewDidDisappear, abyste předešli zbytečným voláním a únikům paměti.

Nevolejte metody vyžadující viditelnou obrazovku. Například pokus o zobrazení UIAlertController z viewDidLoad způsobí chybu, protože View controlleru ještě nebyla přidána do hierarchie oken. Všechny operace UI závislé na window nebo presentedViewController by měly být prováděny až po zobrazení obrazovky.

Neinicializujte těžké zdroje bez potřeby. Pokud se obrazovka otevírá zřídka nebo data nejsou zobrazena okamžitě, odložte vytváření náročných objektů na dobu, kdy jsou skutečně potřeba. Líná inicializace vlastností ve Swift je vestavěný mechanismus pro řešení tohoto úkolu: vlastnost s modifikátorem lazy bude vytvořena až při prvním přístupu, což šetří paměť a zrychluje načítání obrazovky.

Nepoužívejte viewDidLoad pro operace, které by měly být prováděny při každém zobrazení obrazovky. Toto je nejzákladnější chyba: začínající vývojáři často umísťují logiku aktualizace dat do viewDidLoad a diví se, že při návratu z jiné obrazovky se tabulka znovu nenačte. Pokud se operace má opakovat při každém zobrazení — použijte viewWillAppear. Pokud se má provést jednou za život — viewDidLoad. Pamatujte si toto jednoduché pravidlo, abyste předešli většině problémů s životním cyklem UIViewController.

Příklady kódu s viewDidLoad

Podívejme se na tři praktické příklady, které demonstrují správné použití viewDidLoad v reálných projektech. Každý příklad řeší konkrétní úkol konfigurace obrazovky.

Příklad 1: nastavení kolekce s vlastními buňkami

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()
}

Příklad 2: programové nastavení constraintů

override func viewDidLoad() {
    super.viewDidLoad()
    let label = UILabel()
    label.text = "Ahoj, světe!"
    label.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(label)

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

Příklad 3: nastavení prázdného stavu a loaderu

V viewDidLoad se také nastavují prvky zobrazované při absenci dat: prázdný stav, loader, placeholder. Tyto komponenty se vytvářejí jednou a znovu používají při každém zobrazení obrazovky. Skrytí nebo zobrazení těchto prvků je řízeno v viewWillAppear v závislosti na aktuálních datech.

override func viewDidLoad() {
    super.viewDidLoad()
    emptyStateLabel = UILabel()
    emptyStateLabel.text = "Žádná data"
    emptyStateLabel.textAlignment = .center
    emptyStateLabel.isHidden = true
    view.addSubview(emptyStateLabel)

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

Příklad 4: přihlášení k oznámením aplikace

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

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