UINavigationController 🍎

1️⃣ 정의

계층적인 콘텐츠를 탐색하기 위한 스택 기반 체계를 정의하는 컨테이너 뷰 컨트롤러

@MainActor
class UINavigationController : UIViewController

2️⃣ 설명

• 내비게이션 컨트롤러는 탐색 인터페이스에서 하나 이상의 자식 뷰 컨트롤러를 관리하는 container view controller
• 이러한 유형의 인터페이스에서는 한 번에 하나의 자식 뷰 컨트롤러만 표시됨
• 뷰 컨트롤러에서 항목을 선택하면 새로운 뷰 컨트롤러가 애니메이션을 사용하여 화면에 push되며, 이전 뷰 컨트롤러는 숨김
• 인터페이스 상단의 내비게이션 바에서 뒤로 가기 버튼을 탭하면 최상위 뷰 컨트롤러가 제거되어 이전에 있는 뷰 컨트롤러가 나타남
• 앱에서 관리하는 계층 데이터의 구성을 모방하기 위해 내비게이션 인터페이스를 주로 사용함
• 계층의 각 수준에서 해당 수준의 콘텐츠를 표시하는 적절한 화면(사용자 정의 뷰 컨트롤러에 의해 관리됨)을 제공
• 루트 뷰를 제외한 모든 뷰에서 내비게이션 컨트롤러는 계층 구조에서 위로 이동할 수 있도록 뒤로 가기 버튼을 제공
• 내비게이션 컨트롤러 객체는 자식 뷰 컨트롤러를 관리하기 위해 순서대로 정렬된 배열인 내비게이션 스택을 사용
• 배열의 첫 번째 뷰 컨트롤러는 루트 뷰 컨트롤러로서 스택의 가장 아래에 위치
• 배열의 마지막 뷰 컨트롤러는 스택의 가장 위에 있는 항목으로서 현재 표시되는 뷰 컨트롤러를 나타냄
• 이 클래스의 메서드나 세그웨이를 사용하여 뷰 컨트롤러를 스택에 추가하거나 제거할 수 있음
• 사용자는 내비게이션 바의 뒤로 가기 버튼이나 왼쪽 가장자리 스와이프 제스처를 사용하여 최상위 뷰 컨트롤러의 제거가 가능함

📌 Navigation bar, Tool bar

• 내비게이션 컨트롤러는 인터페이스 상단의 내비게이션 바와 인터페이스 하단의 선택적인 툴바를 관리
• 내비게이션 바는 항상 존재하며 내비게이션 컨트롤러 자체에서 관리되며, 자식 뷰 컨트롤러가 제공하는 내용을 사용하여 내비게이션 바를 업데이트함
• isToolbarHidden속성이 false인 경우, 내비게이션 컨트롤러는 마찬가지로 최상위 뷰 컨트롤러가 제공하는 내용으로 툴바를 업데이트함

📌 UINavigationControllerDelegate

• 내비게이션 컨트롤러는 델리게이트 객체와 함께 동작을 조율함
• 델리게이트 객체는 뷰 컨트롤러의 푸시push 또는 팝pop 동작을 재정의하거나 사용자 정의 애니메이션 전환을 제공하며, 내비게이션 인터페이스의 선호 방향을 지정할 수 있음
• 제공하는 델리게이트 객체는 UINavigationControllerDelegate프로토콜을 준수해야 함
• 아래의 이미지는 내비게이션 컨트롤러와 해당 관리 대상 객체들 간의 관계를 보여줌
• 내비게이션 컨트롤러의 지정된 속성을 사용하여 이러한 객체들에 접근할 수 있음
  

📌 Navigation controller views

• 내비게이션 컨트롤러는 컨테이너 뷰 컨트롤러이며, 다른 뷰 컨트롤러의 내용을 자체적으로 내부에 임베드함

  임베드

  • 하나의 뷰 컨트롤러가 다른 뷰 컨트롤러의 콘텐츠를 포함하고 그 안에서 표시되는 것을 의미
  • 내비게이션 컨트롤러에서 뷰 컨트롤러를 임베드하면 내비게이션 컨트롤러는 해당 뷰 컨트롤러의 콘텐츠를 자신의 뷰 안에 표시
  • 인터페이스 빌더에서 임베드 하는 법
  • Xcode ->Editor -> Embed In -> Navigation Controller

• 내비게이션 컨트롤러의 뷰는 view속성을 통해 액세스할 수 있음
• 아래의 예시는 내비게이션 컨트롤러의 view속성을 사용하여 해당 뷰에 액세스함

let navigationController = UINavigationController(rootViewController: yourRootViewController)

// 액세스
let navigationView = navigationController.view

// navigationView를 원하는 방식으로 사용
navigationView.backgroundColor = UIColor.white
navigationView.layer.cornerRadius = 10
// ...

• 이 뷰에는 내비게이션 바, 선택적인 툴바 및 최상위 뷰 컨트롤러에 해당하는 콘텐트 뷰가 포함됨
• 아래의 이미지는 이러한 뷰들이 조합되어 전체적인 내비게이션 인터페이스를 표시하는 방법을 보여줌
• 이 그림에서 내비게이션 인터페이스는 탭 바 인터페이스 안에 추가로 임베드됨
  
• 내비게이션 바와 툴바 뷰의 내용은 변경되지만 뷰 자체는 변경되지 않음
• 실제로 변경되는 것은 내비게이션 스택의 최상위 뷰 컨트롤러에서 제공되는 사용자 정의 콘텐트 뷰뿐임

  content view provided by the topmost view controller

  • 상위 뷰 컨트롤러의 콘텐트 뷰는 내비게이션 스택의 맨 위에 있는 뷰 컨트롤러가 제공하는 실제 화면 콘텐츠를 나타냄

• 내비게이션 컨트롤러는 내비게이션 바와 선택적 내비게이션 툴바의 생성, 구성 및 표시를 관리함
• 내비게이션 바의 외관 관련 속성을 사용자 정의하는 것은 허용되지만, 프레임, 바운드 또는 알파 값을 직접 변경해서는 절대로 안 됨❌
• UINavigationBar를 서브클래싱하는 경우 init(navigationBarClass:toolbarClass:) 메서드를 사용하여 내비게이션 컨트롤러를 초기화해야 함

  서브클래싱

  • 상속을 통해 기존 클래스를 확장하고 새로운 클래스를 생성하는 개념
  • 기존 클래스의 기능을 확장하고 개별적인 동작을 정의

• 내비게이션 바를 숨기거나 표시하려면 isNavigationBarHidden속성이나 setNavigationBarHidden(_:animated:)메서드를 사용
• 내비게이션 컨트롤러는 내비게이션 스택에 있는 뷰 컨트롤러에 연결된 내비게이션 아이템 개체(UINavigationItem클래스의 인스턴스)를 사용하여 내비게이션 바의 내용을 동적으로 구성

  내비게이션 아이템 UINavigationItem

  • 내비게이션 아이템은 타이틀, 바 버튼 항목, 타이틀 뷰 등의 정보를 가지고 있으며, 이를 조작하여 내비게이션 바에 원하는 콘텐츠를 표시함
  • 내비게이션 컨트롤러는 각 뷰 컨트롤러의 내비게이션 아이템을 참조하여 내비게이션 바를 업데이트하고, 이를 통해 화면에 표시되는 내비게이션 바의 내용이 동적으로 변경됨

• 내비게이션 바의 전반적인 외관을 사용자 정의하려면 UIAppearance API를 사용
• 내비게이션 바의 내용을 변경하려면 사용자 정의 뷰 컨트롤러의 내비게이션 아이템을 구성해야 함

📌 Updating the navigation bar

• 최상위 뷰 컨트롤러가 변경될 때마다 내비게이션 컨트롤러는 내비게이션 바를 해당 내용에 맞게 업데이트함
• 구체적으로, 내비게이션 컨트롤러는 내비게이션 바의 세 가지 위치인 왼쪽, 가운데, 오른쪽에 표시되는 바 버튼 항목을 업데이트함 바 버튼 항목은 UIBarButtonItem클래스의 인스턴스
• 필요에 따라 사용자 정의 콘텐트로 항목을 생성하거나 표준 시스템 항목을 생성할 수 있음
• 내비게이션 바의 색상은 내비게이션 바 자체의 속성으로 제어됨
• tintColor속성을 사용하여 바의 항목의 틴트 색상을 변경하고, barTintColor 속성을 사용하여 바 자체의 틴트 색상을 변경함
• 내비게이션 바는 현재 표시된 뷰 컨트롤러에서 틴트 색상을 상속하지 않음

📌 The left item

• 내비게이션 스택의 루트 뷰 컨트롤러를 제외한 모든 뷰 컨트롤러에 대해서는 내비게이션 바의 왼쪽에 있는 항목이 이전 뷰 컨트롤러로의 이동을 제공

  왼쪽 버튼의 내용은 다음과 같이 결정됨

  • 새로운 최상위 뷰 컨트롤러가 사용자 정의 왼쪽 바 버튼 항목을 가지고 있다면 해당 항목이 표시됨
  • 사용자 정의 왼쪽 바 버튼 항목을 지정하려면, 뷰 컨트롤러의 내비게이션 아이템의 leftBarButtonItem속성을 설정

최상위 뷰 컨트롤러가 사용자 정의 왼쪽 바 버튼 항목을 가지고 있지 않지만, 이전 뷰 컨트롤러의 내비게이션 아이템의 backBarButtonItem 속성에 객체가 있는 경우, 내비게이션 바는 해당 항목을 표시합니다.

뷰 컨트롤러들 중 어느 쪽도 사용자 정의 바 버튼 항목을 지정하지 않은 경우, 기본적인 뒤로 가기 버튼이 사용되며, 그 제목은 이전 뷰 컨트롤러의 title 속성의 값으로 설정됩니다. (내비게이션 스택에 뷰 컨트롤러가 하나만 있는 경우, 뒤로 가기 버튼은 표시되지 않습니다.)

---

출처📚

🍎Apple Docs: UINavigationController