Feat: CustomNavigationBar 구현

- CustomNavigationBar 구현
- 기존 UIViewController에서 구현된 configureNavigationBar 삭제

Author: choijungp

Projects/Presentation/Sources/Common/Extension/UIViewController+.swift

@@ -5,93 +5,92 @@
 //  Created by 최정인 on 7/8/25.
 //
 
+import SnapKit
 import UIKit
 
 extension UIViewController {
     // MARK: - NavigationBar
-    func configureNavigationBar(navigationStyle: NavigationBarStyle) {
-        switch navigationStyle {
-        case .hidden:
-            navigationController?.setNavigationBarHidden(true, animated: false)
+    enum NavigationBarStyle {
+        case withBackButton(title: String)  // 백버튼 + 타이틀 (없으면 빈 String)
+        case withTitle(title: String)       // 오로지 타이틀만
+        case withProgressBar(step: Int)     // 백버튼 + progress
+    }
 
-        case .withBackButton(let title):
-            navigationController?.setNavigationBarHidden(false, animated: false)
-            self.title = title
-            configureDefaultBackButton()
-
-        case .withPrograssBar(let step, let stepCount):
-            navigationController?.setNavigationBarHidden(false, animated: false)
-            configureDefaultBackButton()
-            configureProgressNavigationBar(step: step, stepCount: stepCount)
-
-        case .withPrograssBarWithCustomBackButton(let step, let stepCount):
-            navigationController?.setNavigationBarHidden(false, animated: false)
-            configureCustomBackButton()
-            configureProgressNavigationBar(step: step, stepCount: stepCount)
-
-        case .withPrograssBarWithoutBackButton(let step, let stepCount):
-            navigationController?.setNavigationBarHidden(false, animated: false)
-            navigationItem.setHidesBackButton(true, animated: false)
-            configureProgressNavigationBar(step: step, stepCount: stepCount)
+    func configureCustomNaviagtionBar(navigationBarStyle: NavigationBarStyle) {
+        let safeArea = self.view.safeAreaLayoutGuide
+        let navigationBar: UIView = customNavigationBar(navigationBarStyle: navigationBarStyle)
+
+        self.view.addSubview(navigationBar)
+        navigationBar.snp.makeConstraints { make in
+            make.top.horizontalEdges.equalTo(safeArea)
+            make.height.equalTo(48)
         }
     }
 
-    private func configureDefaultBackButton() {
-        let backButton = UIBarButtonItem(
-            image: UIImage(systemName: "chevron.left"),
-            style: .plain,
-            target: self,
-            action: #selector(popViewController))
-        backButton.tintColor = .black
-        navigationItem.leftBarButtonItem = backButton
-        changeNavigationBackground(color: .white)
-    }
+    private func customNavigationBar(navigationBarStyle: NavigationBarStyle) -> UIView {
+        let navigationBar = UIView()
+        let customBackButton = UIButton()
+        let titleLabel = UILabel()
+        let progressView = UIImageView()
 
-    private func configureCustomBackButton() {
-        let backButton = UIBarButtonItem(
-            image: UIImage(systemName: "chevron.left"),
-            style: .plain,
-            target: self,
-            action: #selector(popTwoViewControllers))
-        backButton.tintColor = .black
-        navigationItem.leftBarButtonItem = backButton
-        changeNavigationBackground(color: .white)
-    }
+        customBackButton.setImage(BitnagilIcon.backButtonIcon, for: .normal)
+        customBackButton.addAction(
+            UIAction { [weak self] _ in
+                self?.navigationController?.popViewController(animated: true)
+            },
+            for: .touchUpInside)
 
-    private func configureProgressNavigationBar(step: Int, stepCount: Int) {
-        self.title = ""
-        let progressView = ProgressBarView(step: step, stepCount: stepCount)
-        navigationItem.titleView = progressView
-        changeNavigationBackground(color: BitnagilColor.gray99)
-    }
+        titleLabel.text = " "
+        titleLabel.font = BitnagilFont(style: .title3, weight: .semiBold).font
+        titleLabel.textColor = BitnagilColor.gray10
 
-    @objc private func popViewController() {
-        navigationController?.popViewController(animated: true)
-    }
+        progressView.isHidden = true
+
+        switch navigationBarStyle {
+        case .withBackButton(let title):
+            titleLabel.text = title
 
-    @objc private func popTwoViewControllers() {
-        guard let navigationController = navigationController
-        else { return }
-        let viewControllers = navigationController.viewControllers
+        case .withTitle(let title):
+            titleLabel.text = title
+            customBackButton.isHidden = true
 
-        guard viewControllers.count >= 3 else {
-            navigationController.popViewController(animated: true)
-            return
+        case .withProgressBar(let step):
+            titleLabel.isHidden = true
+            progressView.image = progressImage(step: step)
+            progressView.isHidden = false
         }
 
-        let targetViewController = viewControllers[viewControllers.count - 3]
-        navigationController.popToViewController(targetViewController, animated: true)
-    }
+        navigationBar.backgroundColor = .systemBackground
+        [customBackButton, titleLabel, progressView].forEach {
+            navigationBar.addSubview($0)
+        }
 
-    private func changeNavigationBackground(color: UIColor?) {
-        let appearance = UINavigationBarAppearance()
-        appearance.configureWithOpaqueBackground()
-        appearance.backgroundColor = color
-        appearance.shadowColor = .clear
+        customBackButton.snp.makeConstraints { make in
+            make.top.equalToSuperview()
+            make.leading.equalToSuperview()
+            make.size.equalTo(48)
+        }
+
+        titleLabel.snp.makeConstraints { make in
+            make.center.equalToSuperview()
+        }
+
+        progressView.snp.makeConstraints { make in
+            make.center.equalToSuperview()
+        }
 
-        navigationController?.navigationBar.standardAppearance = appearance
-        navigationController?.navigationBar.scrollEdgeAppearance = appearance
-        navigationController?.navigationBar.compactAppearance = appearance
+        return navigationBar
+    }
+
+    private func progressImage(step: Int) -> UIImage? {
+        switch step {
+        case 1: BitnagilGraphic.progressStep1
+        case 2: BitnagilGraphic.progressStep2
+        case 3: BitnagilGraphic.progressStep3
+        case 4: BitnagilGraphic.progressStep4
+        case 5: BitnagilGraphic.progressStep5
+        default: nil
+        }
     }
 
     // MARK: - BottomSheet
@@ -100,11 +99,3 @@ extension UIViewController {
         present(bottomSheet, animated: true)
     }
 }
-
-enum NavigationBarStyle {
-    case hidden
-    case withBackButton(title: String)
-    case withPrograssBar(step: Int, stepCount: Int)
-    case withPrograssBarWithCustomBackButton(step: Int, stepCount: Int)
-    case withPrograssBarWithoutBackButton(step: Int, stepCount: Int)
-}

Projects/Presentation/Sources/EmotionRegister/View/EmotionRegisterView.swift

@@ -57,7 +57,7 @@ final class EmotionRegisterView: BaseViewController<EmotionRegisterViewModel> {
 
     override func viewWillAppear(_ animated: Bool) {
         super.viewWillAppear(animated)
-        configureNavigationBar(navigationStyle: .withBackButton(title: ""))
+//        configureNavigationBar(navigationStyle: .withBackButton(title: ""))
     }
 
     override func configureAttribute() {

Projects/Presentation/Sources/Home/View/HomeView.swift

@@ -102,15 +102,13 @@ final class HomeView: BaseViewController<HomeViewModel> {
 
     override func viewDidLoad() {
         super.viewDidLoad()
-        configureNavigationBar(navigationStyle: .hidden)
         configureGradientBackground()
         showIndicatorView()
         viewModel.action(input: .loadNickname)
     }
 
     override func viewWillAppear(_ animated: Bool) {
         super.viewWillAppear(animated)
-        configureNavigationBar(navigationStyle: .hidden)
         viewModel.action(input: .loadEmotion)
         viewModel.action(input: .fetchRoutines)
     }

Projects/Presentation/Sources/Login/View/LoginViewController.swift

@@ -45,11 +45,6 @@ public final class LoginViewController: BaseViewController<LoginViewModel> {
         fatalError("init(coder:) has not been implemented")
     }
 
-    public override func viewWillAppear(_ animated: Bool) {
-        super.viewWillAppear(animated)
-        configureNavigationBar(navigationStyle: .hidden)
-    }
-
     public override func viewDidLayoutSubviews() {
         super.viewDidLayoutSubviews()
 
@@ -97,6 +92,7 @@ public final class LoginViewController: BaseViewController<LoginViewModel> {
     override func configureLayout() {
         let safeArea = view.safeAreaLayoutGuide
         view.backgroundColor = .systemBackground
+        navigationController?.setNavigationBarHidden(true, animated: false)
 
         view.addSubview(loginLabel)
         view.addSubview(loginGraphicView)
@@ -158,7 +154,7 @@ public final class LoginViewController: BaseViewController<LoginViewModel> {
                     guard let onboardingViewModel = DIContainer.shared.resolve(type: OnboardingViewModel.self)
                     else { fatalError("onboardingViewModel 의존성이 등록되지 않았습니다.") }
 
-                    let onboardingView = OnboardingView(viewModel: onboardingViewModel, onboarding: .time)
+                    let onboardingView = OnboardingViewController(viewModel: onboardingViewModel, onboarding: .time)
                     self.navigationController?.pushViewController(onboardingView, animated: true)
                 }
             }

Projects/Presentation/Sources/Login/View/TermsAgreementViewController.swift

@@ -15,7 +15,7 @@ import UIKit
 final class TermsAgreementViewController: BaseViewController<LoginViewModel> {
     private enum Layout {
         static let horizontalMargin: CGFloat = 20
-        static let labelTopSpacing: CGFloat = 32
+        static let labelTopSpacing: CGFloat = 86
         static let totalButtonTopSpacing: CGFloat = 28
         static let totalButtonHeight: CGFloat = 52
         static let agreementViewTopSpacing: CGFloat = 8
@@ -39,11 +39,6 @@ final class TermsAgreementViewController: BaseViewController<LoginViewModel> {
         fatalError("init(coder:) has not been implemented")
     }
 
-    override func viewWillAppear(_ animated: Bool) {
-        super.viewWillAppear(animated)
-        configureNavigationBar(navigationStyle: .withBackButton(title: "약관 동의"))
-    }
-
     override func configureAttribute() {
         let text = "빛나길 이용을 위해\n필수 약관에 동의해 주세요."
         agreementLabel.attributedText = BitnagilFont(style: .title2, weight: .bold).attributedString(text: text)
@@ -63,14 +58,16 @@ final class TermsAgreementViewController: BaseViewController<LoginViewModel> {
     override func configureLayout() {
         let safeArea = view.safeAreaLayoutGuide
         view.backgroundColor = .systemBackground
+        navigationController?.setNavigationBarHidden(true, animated: false)
+        configureCustomNaviagtionBar(navigationBarStyle: .withBackButton(title: "약관 동의"))
 
         view.addSubview(agreementLabel)
         view.addSubview(totalAgreementButton)
         view.addSubview(startButton)
 
         agreementLabel.snp.makeConstraints { make in
-            make.leading.equalTo(safeArea).offset(Layout.horizontalMargin)
             make.top.equalTo(safeArea).offset(Layout.labelTopSpacing)
+            make.leading.equalTo(safeArea).offset(Layout.horizontalMargin)
         }
 
         totalAgreementButton.snp.makeConstraints { make in
@@ -126,7 +123,7 @@ final class TermsAgreementViewController: BaseViewController<LoginViewModel> {
                     guard let onboardingViewModel = DIContainer.shared.resolve(type: OnboardingViewModel.self) else {
                         fatalError("onboardingViewModel 의존성이 등록되지 않았습니다.")
                     }
-                    let onboardingView = OnboardingView(viewModel: onboardingViewModel, onboarding: .time)
+                    let onboardingView = OnboardingViewController(viewModel: onboardingViewModel, onboarding: .time)
                     self.navigationController?.pushViewController(onboardingView, animated: true)
                 } else {
                     // TODO: 약관 동의 실패 시, 에러 처리를 해야 합니다.

Projects/Presentation/Sources/Onboarding/View/Component/GradientProgressView.swift

@@ -108,7 +108,7 @@ final class RoutineCreationView: BaseViewController<RoutineCreationViewModel> {
 
     override func viewWillAppear(_ animated: Bool) {
         super.viewWillAppear(animated)
-        configureNavigationBar(navigationStyle: .withBackButton(title: navigationTitle))
+//        configureNavigationBar(navigationStyle: .withBackButton(title: navigationTitle))
     }
 
     override func configureAttribute() {