[🍎 / UIKit] UINavigationController

[UIKit] UINavigationController

Apple Developer Documentation

UINavigtaionController

클래스

계층적인 내용을 탐색하기 위한 스택 기반의 scheme을 정의한 컨테이너 뷰 컨트롤러.

선언

@MainActor class UINavigationController : UIViewController

개요

navigation controller는 하나 이상의 자식 뷰 컨트롤러들을 내비게이션 인터페이스로 관리하는 컨테이너 뷰 컨트롤러입니다. 이 유형의 인터페이스에서는, 한 번에 오직 하나의 자식 뷰 컨트롤러만 보이게 할 수 있습니다. 뷰 컨트롤러에서 요소를 선택하면 새로운 뷰 컨트롤러가 애니메이션을 사용해 스크린에 들어오며(push), 이전의 뷰 컨트롤러는 숨겨집니다. 인터페이스 맨 위의 내비게이션 바에 있는 뒤로 가기 버튼(back button)을 누르면 맨 위의 뷰 컨트롤러(top view controller)가 제거되며, 그로 인해 아래의 뷰 컨트롤러가 드러납니다.

당신의 앱에 의해 관리되는 계층적 데이터의 구조를 흉내내기 위해 내비게이션 인터페이스를 사용하십시오. 계층의 각 수준에서, 그 수준에 대한 컨텐츠를 보여주기 위해 (커스텀 뷰 컨트롤러에 의해 관리되는) 적절한 화면을 제공해야 합니다. 그림1은 iOS 시뮬레이터에 있는 '설정' 앱의 네비게이션 인터페이스의 예시입니다. 첫 번째 화면은 환경 설정을 포함하고 있는 앱의 리스트를 사용자에게 보여줍니다. 앱을 선택하면 그 앱에 대한 개별적인 설정과 그룹 설정이 드러납니다. 그룹을 선택하면 더 많은 설정들이 나타나며 이런 식으로 반복됩니다. root view를 제외한 모든 뷰에 대해서는, 사용자가 상위의 계층으로 되돌아갈 수 있도록 navigation controller가 back 버튼을 제공합니다.

그림1 : 내비게이션 인터페이스의 예시

navigation controller 객체는 navigation stack이라고 알려진, 순서가 있는 배열을 사용해 그것의 자식 뷰 컨트롤러들을 관리합니다. 배열의 첫 번째 뷰 컨트롤러가 root view controller이며, stack의 바닥을 나타냅니다. 배열의 마지막 뷰 컨트롤러는 stack의 최상위 요소이며, 현재 보여지고 있는 뷰 컨트롤러를 나타냅니다. segue를 사용하거나 UINavigationController 클래스의 메서드를 사용해 뷰 컨트롤러들을 stack에 추가하거나 삭제할 수 있습니다. 사용자는 또한 내비게이션 바의 back 버튼을 사용하거나, left-edge 스와이프 제스처를 사용해 최상위 뷰 컨트롤러를 삭제할 수 있습니다.

navigation controller는 인터페이스 상단의 navigation bar와 인터페이스 하단의 선택적인 toolbar를 관리합니다. navigation bar는 항상 보여지며 navigation controller에 의해 관리되며, navigation controller는 자식 뷰 컨트롤러로부터 제공되는 컨텐츠로 navigation bar를 업데이트합니다. 비슷하게, isToolBarHidden 프로퍼티가 false이면, navigation controller는 최상위 뷰 컨트롤러가 제공하는 컨텐츠로 toolbar를 업데이트합니다.

navigation controller는 자신의 동작을 delegate 객체로 조정합니다. delegate객체는 뷰 컨트롤러들의 push 또는 pop을 override하거나, 커스텀 애니메이션 전환을 제공하거나, 내비게이션 인터페이스에 대한 기본 방향을 명시할 수 있습니다. 당신이 제공하는 delegate 객체는 반드시 UINavigationControllerDelegate 프로토콜을 따라야 합니다.

그림2는 navigation controller와 그것이 관리하는 객체들의 관계를 보여줍니다. 이 객체들에 접근하기 위해서는 navigation controller의 명시된 프로퍼티들을 사용하십시오.

그림2 : navigation controller에 의해 관리되는 객체들

 

 

 

Navigation Controller 뷰

navigation controller는 컨테이너 뷰 컨트롤러입니다 - 이 말은, 자신 내부에 다른 뷰 컨트롤러들의 컨텐츠를 포함하고 있다는 말입니다. navigation controller의 뷰에는 view 프로퍼티로 접근할 수 있습니다. 이 뷰는 navigation bar, 선택적인 toolbar, 그리고 최상위 뷰 컨트롤러에 상응하는 content view를 포함합니다. 그림3은 이 뷰들이 전체적인 내비게이션 인터페이스를 보여주기 위해 어떻게 조립되는지를 보여줍니다. (이 그림에서, 내비게이션 인터페이스는 탭 바 인터페이스 내부에 추가로 포함되어 있습니다.) navigation bar의 컨텐츠와 toolbar의 뷰가 바뀌더라도, 뷰 자체는 바뀌지 않습니다. 실제로 바뀌는 뷰는, navigation stack의 최상위 뷰 컨트롤러가 제공하는 커스텀 컨텐츠 뷰 뿐입니다.

그림3 : navigation controller의 뷰들

노트
iOS7 이후 버전부터, 컨텐츠 뷰는 내비게이션 바 아래에 겹쳐집니다. 따라서 뷰 컨트롤러 컨텐츠를 디자인할 때 겹쳐지는 공간을 반드시 고려해야 합니다.

내비게이션 컨트롤러는 navigation bar와 선택적인 내비게이션 툴바의 생성, 구성, 표시를 관리합니다. navigation bar의 외형과 연관된 프로퍼티를 커스텀하는 것은 허용되나, 절대로 navigation bar의 frame, bounds, alpha값을 직접적으로 바꿔서는 안 됩니다. 만약 UINavigationBar를 상속한면, init(navigationBarClass:toolbarClass:) 메서드를 사용해 반드시 내비게이션 컨트롤러를 초기화해야 합니다. navigation bar를 숨기거나 보여주기 위해서는, isNavigationBarHidden 프로퍼티나 setNavigationBarHidden(_:animated:) 메서드를 사용하십시오.

내비게이션 컨트롤러는 내비게이션 스택에 있는 뷰 컨트롤러와 연관된 navigation item 객체(즉, UINavigationItem 클래스의 인스턴스들)를 사용해 navigation bar의 내용을 동적으로 빌드합니다. navigation bar의 전체적인 외형을 커스텀하려면, UIAppearance API를 사용하십시오. navigation bar의 내용을 변경하려면, 커스텀 뷰 컨트롤러의 navigation item을 구성해야 합니다.

navigation bar에 대한 더 많은 정보를 보려면 UINavigationBar를 참고하십시오. bar button item을 어떻게 만드는지에 대한 더 많은 정보를 보려면 UINavigationItem을 참고하십시오.

Navigation Bar 업데이트하기

최상위 뷰 컨트롤러가 바뀔 때마다, 내비게이션 컨트롤러는 그에 따라 navigation bar를 업데이트합니다. 구체적으로는, 내비게이션 컨트롤러는 navigation bar의 세 영역: 왼쪽, 중앙, 오른쪽 각각에 표시되는 bar button items를 업데이트합니다. bar button item은 UIBarButtonItem클래스의 인스턴스입니다. 당신은 필요에 따라 커스텀 컨텐츠로 item을 만들거나, 표준 시스템 아이템을 만들 수 있습니다.

navigation bar의 색을 정하는 것은 navigation bar 자신의 프로퍼티에 의해 관리됩니다. navigation bar의 item의 색을 바꾸기 위해서는 tintColor 프로퍼티를 사용하고, navigation bar 자체의 색을 바꾸기 위해서는 barTintColor 프로퍼티를 사용하십시오. navigation bar는 현재 보여지고 있는 뷰 컨트롤러로부터 색상을 상속하지 않습니다.

navigation bar에 대한 더 많은 정보를 위해서는 UINavigationBar를 참고하십시오. bar button item을 어떻게 만드는지에 대한 더 많은 정보를 보려면 UIBarButtonItem 을 참고하십시오.

왼쪽 item

내비게이션 스택에서 루트 뷰 컨트롤러만 제외하고, navigation bar의 왼쪽 item은 이전 뷰 컨트롤러로 되돌아갈 수 있도록 해줍니다(뒤로 가기 버튼). 맨 왼쪽에 위치하는 버튼(left-most button)은 다음과 같이 결정됩니다:

• 최상위 뷰 컨트롤러가 custom left bar button item을 가지고 있다면, 그 item이 표시됩니다. custom left bar button item를 지정하기 위해서는, 뷰컨트롤러의 navigtaion item으로 leftBarButtonItem 프로퍼티를 설정하십시오.
• 최상위 뷰 컨트롤러가 custom left bar button item을 가지고 있지 않지만, 이전 뷰 컨트롤러의 navigation item에 backBarButtonItem 프로퍼티로 지정된 객체를 가지고 있다면, navigation bar에 그 item이 표시됩니다.
• 만약 custom bar button이 최상위 뷰 컨트롤러와 이전 뷰 컨트롤러에 모두 지정되어 있지 않다면, 기본 뒤로가기 버튼이 사용되며, 뒤로가기 버튼의 title은 이전 뷰 컨트롤러의 title프로퍼티의 값으로 설정됩니다 - 스택 상에서 한 층 아래의 뷰 컨트롤러를 말합니다. (만약 내비게이션 스택에 단 하나의 뷰 컨트롤러만이 존재한다면, 뒤로가기 버튼이 표시되지 않습니다.)

노트
뒤로 가기 버튼의 title이 가용영역에 비해 너무 긴 경우, navigation bar가 실제 버튼 title 대신 “Back”이라는 문자열을 사용할 수 있습니다. navigation bar는 뒤로가기 버튼이 이전 뷰 컨트롤러에 의해 제공될 때만 이렇게 합니다. 만약 새 최상위 뷰 컨트롤러가 custom left bar button item(그 뷰 컨트롤러의 navigation item에 leftBarButtonItem 또는 leftBarButtonItems 프로퍼티로 지정된 객체)을 갖는 경우, navigation bar는 버튼의 title을 바꾸지 않습니다.

중앙 item

내비게이션 컨트롤러는 navigation bar의 중앙을 다음과 같이 업데이트합니다:

• 새 최상위 뷰 컨트롤러가 custom title view를 갖는다면, navigation bar는 기본 title view 자리에 그 뷰를 표시합니다.
• custom title view가 설정되어 있지 않다면, navigation bar는 뷰 컨트롤러의 기본 title를 담은 label을 표시합니다. 이 label의 문자열은 일반적으로 뷰 컨트롤러의 title 프로퍼티에 포함된 값이 됩니다. 만약 뷰 컨트롤러의 title이 아닌 다른 title을 표시하고 싶다면, 뷰 컨트롤러의 navigation item의 title 프로퍼티를 대신 설정하십시오.

오른쪽 item

내비게이션 컨트롤러는 navigation bar의 오른쪽 영역을 다음과 같이 업데이트합니다:

• 최상위 뷰 컨트롤러가 custom right bar button item을 갖는다면, 그 item이 표시됩니다. custom right bar button item을 지정하려면, 뷰 컨트롤러의 navigation item으로 rightBarButtonItem 프로퍼티를 설정하십시오.
• custom right bar button item이 지정되어 있지 않다면, navigation bar는 bar의 오른쪽 영역에 아무것도 표시하지 않습니다.

Toolbar 표시하기

내비게이션 컨트롤러 객체는 선택적인 toolbar를 자신의 뷰 계층 속에서 관리합니다. 표시될 떄, toolbar는 유효한 뷰컨트롤러의 toolbarItems 프로퍼티로부터 자신의 현재 요소들을 가져옵니다. 유효한 뷰컨트롤러가 바뀌면, 내비게이션 컨트롤러는 toolbar item들을 새로운 뷰컨트롤러에 맞게 수정하며, 적절한 경우에 새 요소들이 그 위치로 등장할 때 애니메이션 효과를 줍니다.

내비게이션 toolbar는 기본적으로 숨겨져 있으나, 내비게이션 컨트롤러 객체의 setToolbarHidden(_:animated:) 메서드를 호출해 내비게이션 인터페이스에 toolbar를 표시할 수 있습니다. 모든 뷰컨트롤러가 toolbar item을 지원하지는 않는다면, delegate 객체가 후속 push 또는 pop 연산을 할 때 toolbar의 표시 여부를 전환하도록 이 메서드를 호출하게 할 수 있습니다. custom UIToolbar 하위 클래스를 사용하려면, init(navigationBarClass:toolbarClass:) 를 사용해 내비게이션 컨트롤러를 초기화하십시오. 만약 custom tooolbar와 navigation bar의 하위 클래스를 사용해 내비게이션 컨트롤러를 만든다면, 내비게이션 컨트롤러를 화면에 표시하기 전에 뷰컨트롤러를 push하고 설정하는 작업을 직접 해야 한다는 것을 기억하십시오.

다른 환경에 적용하기

내비게이션 인터페이스는 압축된 수평(horizontally compact)환경과 일반적인 수평(horizontally regular)환경 모두에 동일하게 적용됩니다. 두 환경을 전환할 때는 내비게이션 컨트롤러의 뷰의 크기만이 바뀝니다. 내비게이션 컨트롤러가 뷰 계층이나 뷰의 레이아웃을 바꾸지는 않습니다.

내비게이션 스택의 뷰 컨트롤러들 사이의 segue를 구성할 때, 일반적인 Show segue와 Show Detail segue는 다음과 같이 동작합니다:

• Show segue
  • 내비게이션 컨트롤러가 자신의 내비게이션 스택에 지정된 뷰 컨트롤러를 push합니다.
• Show Detail segue
  • 내비게이션 컨트롤러가 지정된 뷰 컨트롤러를 modal로 보여줍니다.

다른 타입의 segue들의 동작은 변하지 않습니다.

인터페이스 동작

내비게이션 컨트롤러는 자신의 인터페이스에 대해 아래와 같은 동작을 지원합니다:

• 지원되는 인터페이스 방향 (supported interface orientations)
  • 내비게이션 컨트롤러 객체는 지원되는 인터페이스 방향을 결정할 때 내비게이션 스택에 있는 뷰 컨트롤러들을 찾지 않습니다. 아이폰에서, 내비게이션 컨트롤러는 거꾸로 된 세로 방향만 빼고 모든 방향을 지원합니다. 아이패드에서, 내비게이션 컨트롤러는 모든 방향을 지원합니다. 만약 내비게이션 컨트롤러가 delegate객체가 있다면, 그 delegate에서navigationControllerSupportedInterfaceOrientations(_:) 메서드를 사용해 서로 다른 지원되는 방향의 집합을 지정할 수 있습니다.
• 표시 문맥 (presentation context)
  • 내비게이션 컨트롤러는 modal로 표시되는 뷰 컨트롤러에 대한 표시 문맥을 정의합니다. modal 전환 스타일이 UIModalPresentationStyle.currentContext 이거나
    UIModalPresentationStyle.overCurrentContext 이라면, 내비게이션 스택의 뷰 컨트롤러부터의 modal 표시는 전체 내비게이션 인터페이스를 덮게 됩니다.

상태 보존

내비게이션 컨트롤러의 restorationIdentifier 프로퍼티에 값을 할당하면, 그것은 내비게이션 스택에 있는 자기 자신과 자식 뷰 컨트롤러들을 보존하려고 합니다. 내비게이션 컨트롤러는 스택의 맨 아래에서 시작해 위쪽으로 이동하며, 이때 유효한 복원 식별자 문자열을 가진 뷰 컨트롤러 각각을 인코딩합니다. 다음 실행 사이클 동안, 내비게이션 컨트롤러는 보존된 뷰 컨트롤러들을 보존된 순서와 같은 순서로 내비게이션 스택에 복원합니다.

내비게이션 스택에 push한 자식 뷰 컨트롤러들은 같은 복원 식별자를 사용할 수 있습니다. 내비게이션 컨트롤러는 자동으로 추가적인 정보를 저장해, 각 자식 뷰 컨트롤러들의 복원 경로가 유일하도록 보장합니다.

상태 보존과 복원이 어떻게 동작하는지에 대한 자세한 정보를 위해서는, Preserving your app’s UI across launches 를 참조하십시오.