탐색 창
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
탐색 창은 사용자가 다양한 대상과 기능에 액세스할 수 있도록 해주므로 모든 TV 앱에서 필수 구성요소입니다. 탐색 창은 앱의 정보 아키텍처의 핵심이며 앱을 탐색하는 명확하고 직관적인 방법을 제공합니다.
모바일 탐색 창과 달리 TV의 탐색 창에는 사용자에게 확장된 상태와 접힌 상태가 모두 표시됩니다.

리소스
하이라이트
- 도착 페이지는 사용자 중요도에 따라 정렬되며, 자주 방문하는 도착 페이지가 먼저 표시되고 관련 도착 페이지가 그룹화됩니다.
- 탐색 레일은 표준 탐색 창과 모달 탐색 창 모두에 접었을 때 필요합니다.
변형
탐색 창 스타일에는 두 가지 유형이 있습니다.
- 표준 탐색 창: 탐색을 위한 공간을 추가로 만들기 위해 확장되며 페이지 콘텐츠를 옆으로 밀어냅니다.
- 모달 탐색 창: 탐색 창이 확장될 때 가독성을 개선하는 데 도움이 되는 스림이 있는 앱 콘텐츠 위에 오버레이로 표시됩니다.


표준 탐색 창
분석

- 상단 섹션: 앱 로고가 표시됩니다. 프로필을 전환하거나 검색 작업을 트리거하는 버튼 역할을 합니다. 접힌 상태에서는 아이콘만 상단 컨테이너에 표시됩니다.
- 탐색 항목: 탐색 레일의 각 항목에는 아이콘과 텍스트가 조합되어 있으며 접힌 상태에서는 아이콘만 표시됩니다.
- 탐색 레일: 탐색 레일은 3~7개의 앱 대상을 표시하는 열로, 기본 메뉴 역할을 합니다. 각 대상에는 텍스트 라벨과 선택적 아이콘이 있으며, 더 나은 문맥을 위해 메뉴 항목을 그룹화할 수 있습니다.
- 하단 섹션: 설정, 도움말, 프로필과 같은 페이지에 적합한 작업 버튼을 1~3개 표시할 수 있습니다.
동작
- 탐색 창 확장: 확장하면 표준 탐색 창이 페이지 콘텐츠를 밀어 탐색의 확장된 버전을 위한 공간을 만듭니다.
- 탐색 업데이트: 한 탐색 항목에서 다른 탐색 항목으로 이동하면 페이지가 새 대상으로 자동 업데이트됩니다.
모달 탐색 창
분석

- 상단 섹션: 앱 로고가 표시됩니다. 프로필을 전환하거나 검색 작업을 트리거하는 버튼 역할을 합니다. 접힌 상태에서는 아이콘만 상단 컨테이너에 표시됩니다.
- 탐색 항목: 탐색 레일의 각 항목에는 아이콘과 텍스트가 조합되어 있으며 접힌 상태에서는 아이콘만 표시됩니다.
- 탐색 레일: 3~7개의 앱 대상을 표시하는 열로, 기본 메뉴 역할을 합니다. 각 대상에는 텍스트 라벨과 선택사항인 아이콘이 있으며, 더 나은 문맥을 위해 메뉴 항목을 그룹화할 수 있습니다.
- 스크림: 탐색 항목 텍스트의 가독성을 높이기 위해 사용합니다.
- 하단 섹션: 설정, 도움말, 프로필과 같은 페이지에 적합한 작업 버튼을 1~3개 표시할 수 있습니다.
동작
- 서랍 확장: 앱 콘텐츠 위에 오버레이로 표시되며 서랍이 확장될 때 가독성을 개선하는 스크림이 있습니다.
- 탐색 업데이트: 사용자가 탐색 항목을 선택할 때 발생합니다.
스크림
모달 탐색 창의 경우 창 뒤에 있는 스림을 통해 창 콘텐츠를 읽을 수 있습니다. 탐색 창 뒤에 그라데이션이나 단색 노출 영역을 사용하여 다양한 UI 변형을 만들 수 있습니다.

그라데이션 스크림

단색 스크림
사양



사용
활성 표시기
활성 표시기는 표시되는 탐색 창 대상을 강조 표시하는 시각적 신호입니다. 표시기는 일반적으로 드로어의 다른 항목과 시각적으로 구별되는 배경 도형으로 표시됩니다.
활성 표시기는 사용자가 앱에서 현재 어디에 있고 어떤 대상을 탐색하고 있는지 파악하는 데 도움이 됩니다. 활성 표시기가 명확하게 표시되고 탐색 창의 다른 항목과 더 쉽게 구분할 수 있는지 확인합니다.
구분선 (선택사항)
구분선을 사용하면 탐색 창 내에서 대상 그룹을 구분하여 더 효과적으로 정리할 수 있습니다. 하지만 구분선을 너무 많이 사용하면 시각적 혼란을 야기하고 사용자에게 불필요한 인지 부하를 줄 수 있으므로 가급적 사용하지 않는 것이 좋습니다.
배지
배지는 탐색 항목에 추가하여 추가 정보를 제공할 수 있는 시각적 신호입니다. 예를 들어 배지는 스트리밍 앱에서 제공되는 새 영화 수를 표시하는 데 사용할 수 있습니다. 배지는 UI가 복잡해 보이게 할 수 있으므로 필요한 경우에만 쓰고 가급적 사용하지 마세요. 배지를 사용할 때는 명확하고 이해하기 쉬워야 하며 사용자의 앱 탐색 기능을 방해해서는 안 됩니다.

배지 펼쳐짐

배지가 접혀 있음
라벨
탐색 창의 라벨은 읽기 쉽게 명확하고 간결해야 합니다.
warning
주의
긴 라벨을 사용하지 않을 수 없는 경우 말줄임표를 사용하여 라벨을 자릅니다.
cancel
금지사항
줄바꿈이 필요한 긴 텍스트 라벨은 사용하지 마세요.
cancel
금지사항
아이콘이 없는 탐색 창을 만들지 마세요. 사용자가 앱을 탐색하기 어려울 수 있습니다.
cancel
금지사항
아이콘 탐색 항목을 아이콘이 아닌 탐색 항목과 혼합하면 사용자에게 혼란스러운 탐색 환경이 될 수 있으므로 주의하세요.
탐색 창은 앱의 계층 구조를 나타내는 기본 요소이며 5~6개의 기본 탐색 대상만 나열하는 데 사용해야 합니다.
check_circle
권장사항
더 나은 사용자 환경을 위해 탐색 창의 기본 탐색 대상 수를 5~6개로 제한합니다.
cancel
금지사항
탐색 항목을 너무 많이 추가하면 세로 스크롤이 생성되고 사용자가 앱을 탐색하기 어려워질 수 있으므로 주의하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Navigation drawers are essential components in any TV app as they allow users\nto access different destinations and features. A navigation drawer is the\nbackbone of the app's information architecture, providing a clear and intuitive\nway to navigate through the app.\n\nIn contrast to the mobile navigation drawer, the navigation drawer on\nTV has both expanded and collapsed states visible to the user.\n\nResources\n---------\n\n| Type | Link | Status |\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|\n| Design | [Design source (Figma)](https://goo.gle/tv-desing-kit) | Available |\n| Implementation | [Jetpack Compose (NavigationDrawer)](/reference/kotlin/androidx/tv/material3/package-summary#NavigationDrawer(kotlin.Function2,androidx.compose.ui.Modifier,androidx.tv.material3.DrawerState,kotlin.Function0)) [Jetpack Compose (ModalNavigationDrawer)](/reference/kotlin/androidx/tv/material3/package-summary#ModalNavigationDrawer(kotlin.Function2,androidx.compose.ui.Modifier,androidx.tv.material3.DrawerState,androidx.compose.ui.graphics.Brush,kotlin.Function0)) | Available |\n\nHighlights\n----------\n\n- Destinations are ordered according to user importance, with frequent destinations first and related destinations grouped together.\n- A navigation rail is required for both standard and modal navigation drawers when collapsed.\n\nVariants\n--------\n\nThere are two type of navigation drawer styles:\n\n1. **Standard navigation drawer** --- Expands to create additional space for navigation, pushing the page content aside.\n2. **Modal navigation drawer** --- Appears as an overlay on top of the app's content with a scrim that helps to improve readability when the drawer is expanded.\n\nStandard navigation drawer\n--------------------------\n\n### Anatomy\n\n1. **Top section:** Features the app logo. Serves as a button to switch profiles or to trigger search action. In the collapsed state, only the icon remains visible in the top container.\n2. **Navigation item:** Each item in the navigation rail features a combination of an icon and text, with only the icon visible in the collapsed state.\n3. **Navigation rail:** The Navigation Rail is a column that shows 3 to 7 app destinations, acting as the main menu. Each destination has a text label and an optional icon, with the option of grouping menu items for better contextuality.\n4. **Bottom section:** Can have one to three action buttons, which are ideal for pages like settings, help, or profile.\n\n### Behavior\n\n- **Navigation drawer expansion:** When expanded the standard navigation drawers pushes the page content making space for the expanded version for the navigation.\n- **Navigation updates:** Moving from one nav item to another, the page automatically updates to the new destination.\n\nModal navigation drawer\n-----------------------\n\n### Anatomy\n\n1. **Top section:** Features the app logo. Serves as a button to switch profiles or to trigger a search action. In the collapsed state, only the icon remains visible in the top container.\n2. **Navigation item:** Each item in the navigation rail features a combination of an icon and text, with only the icon visible in the collapsed state.\n3. **Navigation rail:** Column that shows three to seven app destinations, acting as the main menu. Each destination has a text label and an optional icon, with the option of grouping menu items for better contextuality.\n4. **Scrim:** For better readability of navigation item text.\n5. **Bottom section:** Can have one to three action buttons, which are ideal for pages like settings, help, or profile.\n\n### Behavior\n\n- **Drawer expansion:** Appears as an overlay on top of the app's content, with a scrim that improves readability when the drawer is expanded.\n- **Navigation updates:** Occur when the user selects a navigation item.\n\n### Scrim\n\nFor the modal navigation drawer, a scrim behind the\ndrawer ensures the drawer content is readable. You can\nuse a gradient or solid surface behind the navigation drawer to create different\nvariations of the UI.\n\n\nGradient scrim \n\nSolid scrim\n\n\u003cbr /\u003e\n\nSpec\n----\n\nUsage\n-----\n\n\n### Active Indicator\n\nThe active indicator is a visual cue that highlights the navigation drawer\ndestination that is displayed. The indicator is typically represented by a\nbackground shape that is visually distinct from the other items in the drawer.\nThe active indicator helps users understand where they are in the app and which\ndestination they are browsing. Ensure that the active indicator is clearly\nvisible and easier to distinguish from the other items in the navigation drawer. \n\n\u003cbr /\u003e\n\n\n### Dividers (optional)\n\nDividers can be used to separate groups of destinations within the navigation\ndrawer for better organization. However, it's important to use them sparingly as\ntoo many dividers can create visual noise and add unnecessary cognitive overload\nfor users. \n\n\u003cbr /\u003e\n\n### Badges\n\nBadges are visual cues that can be added to navigation items to provide\nadditional information. For example, a badge could be used to\nindicate the number of new movies available in a streaming app. Use\nbadges sparingly and only when necessary, as they can\nmake the UI appear busy and cluttered. When using badges, ensure that\nthey are clear and easier to understand and that they don't\ninterfere with the user's ability to navigate the app.\n\n\nBadge expanded \n\nBadge collapsed\n\n\u003cbr /\u003e\n\n### Labels\n\nLabels in the navigation drawer should be clear and concise so that they\nare easier to read. \nwarning\n\n### Caution\n\nIf it's impossible to avoid using long labels, truncate the label using an ellipsis. \ncancel\n\n### Don't\n\nAvoid using long text labels that require wrapping. \ncancel\n\n### Don't\n\nAvoid creating a navigation drawer without icons, as this can make it difficult for users to navigate the app. \ncancel\n\n### Don't\n\nAvoid mixing icon navigation items with non-icon navigation items, as this can make the navigation experience confusing for users.\n\nNavigation drawers are foundational elements that represent your app's\nhierarchy and should be used to list only five to six primary\nnavigation destinations. \ncheck_circle\n\n### Do\n\nLimit the number of main navigation destinations in the navigation drawer to five to six for a better user experience. \ncancel\n\n### Don't\n\nAvoid adding too many navigation items as this can create a vertical scroll and make it harder for users to navigate the app."]]