“`html

Swift UINavigationController 導航控制器完整教學（2025 最新版本）🚶

在iOS開發中，UINavigationController 是一個非常重要的控制器，它能夠幫助開發者在應用程式中建立一個層級架構，從而在不同頁面之間輕鬆切換。本文將介紹如何使用 Swift 的最新語法來實作 UINavigationController，並分享最佳實踐與常見問題解決方案。

什麼是 Swift UINavigationController？

Swift 的 UINavigationController 是一種容器視圖控制器，它能夠管理一個頁面堆棧，並允許用戶在這些頁面之間進行導航。它的主要功能包括推送（push）和彈出（pop）視圖控制器，並且提供了一個標題欄（navigation bar）來顯示當前頁面的標題和操作按鈕。

如何使用 Swift UINavigationController？

使用 UINavigationController 的基本步驟如下：

1. 在你的應用程式中創建一個 UINavigationController。
2. 設置根視圖控制器。
3. 使用 pushViewController 方法來推送新的視圖控制器。

示範程式碼：

以下是一個簡單的示例，展示了如何使用 Swift 的 UINavigationController：

swift
import UIKit

class RootViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .white
        let button = UIButton(type: .system)
        button.setTitle("前往下一頁", for: .normal)
        button.addTarget(self, action: #selector(navigateToNextPage), for: .touchUpInside)
        button.center = view.center
        view.addSubview(button)
    }

    @objc func navigateToNextPage() {
        let nextViewController = NextViewController()
        navigationController?.pushViewController(nextViewController, animated: true)
    }
}

class NextViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .lightGray
    }
}

// 在 AppDelegate 或 SceneDelegate 中設置 UINavigationController
let rootViewController = RootViewController()
let navigationController = UINavigationController(rootViewController: rootViewController)
window?.rootViewController = navigationController
window?.makeKeyAndVisible()

在上面的示例中，我們首先建立了一個 UINavigationController，並將根視圖控制器設置為 RootViewController。接著，當用戶點擊按鈕時，新的視圖控制器將被推送到導航堆棧中。

常見錯誤與排除方法

• 無法推送新視圖控制器：確保你的視圖控制器是被 UINavigationController 管理的，且 navigationController 不是 nil。
• 導航條不顯示：檢查 UINavigationController 是否正確設置為根控制器。

延伸應用

UINavigationController 不僅僅用於簡單的頁面導航，還可以與其他控制器（如 UITabBarController）結合使用，創建更複雜的導航結構。此外，還可以通過自定義導航條來增強用戶體驗。

結論

Swift 的 UINavigationController 是構建 iOS 應用程式中不可或缺的部分。透過簡單的設置與使用，你可以輕鬆地管理應用內的頁面導航。

Q&A（常見問題解答）

Q1: 如何自定義導航條的外觀？

A1: 你可以使用 UINavigationBarAppearance 來自定義導航條的顏色、字體和透明度等屬性。

Q2: 如何返回上個頁面？

A2: 使用 UINavigationController 的 popViewController(animated:) 方法可以返回上個頁面。

Q3: UINavigationController 支持多層導航嗎？

A3: 是的，UINavigationController 可以支持多層次的導航，你可以在一個視圖控制器中推送另一個 UINavigationController。

“`
—