2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
툴바
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
다이얼러는 패키지 이름이 com.android.car.ui.toolbar.Toolbar인 섀시 툴바를 사용합니다.
툴바를 맞춤설정하는 첫 번째 단계는 레이아웃 파일 car_ui_toolbar.xml을 오버레이하는 것입니다. 기존 툴바의 경우에는 car_ui_toolbar_two_row.xml을, 기본 레이아웃 버전의 경우에는 car_ui_base_layout_toolbar.xml을 오버레이하면 됩니다. 레이아웃의 각 버전에서 다음 각 뷰를 관련 ID와 함께 제공해야 합니다.
| id |
뷰 유형 |
설명 |
car_ui_toolbar_background/td> | android.view.View |
기본 레이아웃은 지원 중단되었지만, 높이를 확인할 때 이전 툴바 스타일과 함께 사용됩니다. |
car_ui_toolbar_tabs |
com.android.car.ui.toolbar.TabLayout |
탭의 위치. |
car_ui_toolbar_nav_icon |
android.widget.ImageView |
뒤로, 닫기, 아래쪽 버튼. |
car_ui_toolbar_logo |
android.widget.ImageView |
car_ui_toolbar_logo_
fills_nav_icon_space가 true인 경우의 로고. |
car_ui_toolbar_nav_icon_container |
android.view.ViewGroup |
car_ui_toolbar_logo 및 car_ui_toolbar_nav_icon을 포함할 컨테이너. |
car_ui_toolbar_menu_items_container |
android.view.ViewGroup |
MenuItem을 포함할 ViewGroup. |
car_ui_toolbar_title |
android.widget.TextView |
툴바의 제목. |
car_ui_toolbar_title_logo_container |
android.view.ViewGroup |
car_ui_toolbar_title_logo의 컨테이너. ImageView 대신 컨테이너가 표시되거나 숨겨집니다. |
car_ui_toolbar_title_logo |
android.widget.ImageView |
car_ui_toolbar_logo_
fills_nav_icon_space가 false인 경우의 로고. |
car_ui_toolbar_search_view_container |
android.widget.FrameLayout |
검색 뷰가 확장되는 컨테이너. 이로 인해 검색창이 없는 화면에서의 확장 시간이 단축됩니다. |
car_ui_toolbar_progress_bar |
android.widget.ProgressBar |
진행률 표시줄. |
그다음, 검색창이 포함된 car_ui_toolbar_search_view.xml도 맞춤설정해야 합니다. 여기에는 다음 뷰가 있어야 합니다.
| id |
뷰 유형 |
설명 |
car_ui_toolbar_search_bar |
android.widget.EditText |
사용자가 검색할 텍스트를 입력하는 EditText |
car_ui_toolbar_search_icon |
android.widget.ImageView |
일반적으로 검색 아이콘을 표시하지만 애플리케이션에서 변경할 수 있는 아이콘 |
car_ui_toolbar_search_close |
android.view.View |
클릭하면 검색창이 삭제되는 뷰 |
레이아웃 외에도 다음 불리언 속성을 사용하여 툴바를 맞춤설정할 수 있습니다.
| 속성 |
설명 |
car_ui_toolbar_tabs_on_second_row |
탭을 표시할 때 제목을 숨길지 결정합니다. |
car_ui_toolbar_nav_icon_reserve_space |
탐색 아이콘이 숨겨져 있을 때 탐색 아이콘 공간을 차지하도록 제목을 왼쪽으로 옮길지 결정합니다. |
car_ui_toolbar_logo_fills_nav_icon_space |
탐색 버튼이 없는 경우 탐색 버튼과 동일한 공간에 로고를 표시합니다. |
car_ui_toolbar_show_logo |
툴바에 로고를 영구적으로 표시하지 않게 하려면 false로 설정합니다. |
이러한 뷰는 ToolbarControllerImpl 메서드의 setState를 기반으로 표시되거나 숨겨지거나 변경됩니다. 표시되는 뷰 유형과 시점에 관한 자세한 내용은 관련 메서드를 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 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,["# Toolbar\n\nDialer uses the chassis toolbar with a package name of\n`com.android.car.ui.toolbar.Toolbar`.\n\nThe first step to customizing the toolbar is to overlay the layout file, which is\n`car_ui_toolbar.xml` and `car_ui_toolbar_two_row.xml` for the legacy toolbar,\nand `car_ui_base_layout_toolbar.xml` for the base layout version. In each version of the\nlayout, each of the following views must be provided with the respective ids:\n\n| id | View type | Description |\n|----------------------------------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| `car_ui_toolbar_background`/td\\\u003e | `android.view.View` | Deprecated for base layouts, but used with the previous toolbar style to determine height. |\n| `car_ui_toolbar_tabs` | `com.android.car.ui.toolbar.TabLayout` | Location of tabs. |\n| `car_ui_toolbar_nav_icon` | `android.widget.ImageView` | The Back, Close, Down button. |\n| `car_ui_toolbar_logo` | `android.widget.ImageView` | The logo, when car_ui_toolbar_logo_ fills_nav_icon_space is `true`. |\n| `car_ui_toolbar_nav_icon_container` | `android.view.ViewGroup` | A container to hold `car_ui_toolbar_logo` and `car_ui_toolbar_nav_icon`. |\n| `car_ui_toolbar_menu_items_container` | `android.view.ViewGroup` | A ViewGroup to contain MenuItems. |\n| `car_ui_toolbar_title` | `android.widget.TextView` | The title of the toolbar. |\n| `car_ui_toolbar_title_logo_container` | `android.view.ViewGroup` | A container for the `car_ui_toolbar_title_logo`. The container will be displayed (or hidden) instead of the ImageView. |\n| `car_ui_toolbar_title_logo` | `android.widget.ImageView` | The logo, when car_ui_toolbar_logo_ fills_nav_icon_space is `false` |\n| `car_ui_toolbar_search_view_container` | `android.widget.FrameLayout` | A container into which the search view is to be inflated. This reduces inflation durations on screens without Search bars. |\n| `car_ui_toolbar_progress_bar` | `android.widget.ProgressBar` | A progress bar. |\n\nNext, you must also customize `car_ui_toolbar_search_view.xml`, which contains the\nSearch bar, which must have the following views:\n\n| id | View type | Description |\n|-------------------------------|----------------------------|--------------------------------------------------------------------------------|\n| `car_ui_toolbar_search_bar` | `android.widget.EditText` | The EditText where the user types text to search. |\n| `car_ui_toolbar_search_icon` | `android.widget.ImageView` | An icon, that normally shows a search icon but can be changed by applications. |\n| `car_ui_toolbar_search_close` | `android.view.View` | A view that when clicked will clear the search box |\n\nIn addition to the layout, you can use these Boolean attributes to customize the toolbar:\n\n| Attribute | Description |\n|--------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `car_ui_toolbar_tabs_on_second_row` | Determines whether or not to hide the title when tabs are displayed. |\n| `car_ui_toolbar_nav_icon_reserve_space` | Determines if the title should be moved to the left to occupy the space of the Navigation icon when the Navigation icon is hidden. |\n| `car_ui_toolbar_logo_fills_nav_icon_space` | Display the logo in the same space as the Navigation button when no Navigation button is present. |\n| `car_ui_toolbar_show_logo` | To permanently disable the display of a logo in the toolbar, set this to `false`. |\n\nThese views are displayed, hidden, or changed based on the `setState` of the\n`ToolbarControllerImpl` method. For specifics about which view is displayed and when,\nsee that method."]]
