A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release
en lugar de aosp-main
para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.
Barra de herramientas
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El selector usa la barra de herramientas del chasis con un nombre de paquete de com.android.car.ui.toolbar.Toolbar
.
El primer paso para personalizar la barra de herramientas es superponer el archivo de diseño, que es car_ui_toolbar.xml
y car_ui_toolbar_two_row.xml
para la barra de herramientas heredada, y car_ui_base_layout_toolbar.xml
para la versión de diseño base. En cada versión del diseño, cada una de las siguientes vistas debe proporcionarse con los IDs correspondientes:
id |
Tipo de vista |
Descripción |
car_ui_toolbar_background /td>
| android.view.View |
Dejó de estar disponible para los diseños básicos, pero se usa con el estilo de barra de herramientas anterior para determinar la altura. |
car_ui_toolbar_tabs |
com.android.car.ui.toolbar.TabLayout |
Ubicación de las pestañas. |
car_ui_toolbar_nav_icon |
android.widget.ImageView |
Los botones Atrás, Cerrar y Abajo |
car_ui_toolbar_logo |
android.widget.ImageView |
El logotipo, cuando car_ui_toolbar_logo_ fills_nav_icon_space es true . |
car_ui_toolbar_nav_icon_container |
android.view.ViewGroup |
Un contenedor para contener car_ui_toolbar_logo y car_ui_toolbar_nav_icon . |
car_ui_toolbar_menu_items_container |
android.view.ViewGroup |
Un ViewGroup para contener MenuItems. |
car_ui_toolbar_title |
android.widget.TextView |
Es el título de la barra de herramientas. |
car_ui_toolbar_title_logo_container |
android.view.ViewGroup |
Es un contenedor para car_ui_toolbar_title_logo . El contenedor se mostrará (o ocultará) en lugar del ImageView. |
car_ui_toolbar_title_logo |
android.widget.ImageView |
El logotipo, cuando car_ui_toolbar_logo_ fills_nav_icon_space es false |
car_ui_toolbar_search_view_container |
android.widget.FrameLayout |
Un contenedor en el que se debe aumentar la vista de búsqueda. Esto reduce las duraciones de inflación en pantallas sin barras de búsqueda. |
car_ui_toolbar_progress_bar |
android.widget.ProgressBar |
Una barra de progreso. |
A continuación, también debes personalizar car_ui_toolbar_search_view.xml
, que contiene la barra de búsqueda, que debe tener las siguientes vistas:
id |
Tipo de vista |
Descripción |
car_ui_toolbar_search_bar |
android.widget.EditText |
Es el EditText en el que el usuario escribe el texto para realizar la búsqueda. |
car_ui_toolbar_search_icon |
android.widget.ImageView |
Es un ícono que, por lo general, muestra un ícono de búsqueda, pero que las aplicaciones pueden cambiar. |
car_ui_toolbar_search_close |
android.view.View |
Una vista que, cuando se haga clic en ella, borrará el cuadro de búsqueda |
Además del diseño, puedes usar estos atributos booleanos para personalizar la barra de herramientas:
Atributo |
Descripción |
car_ui_toolbar_tabs_on_second_row |
Determina si se oculta o no el título cuando se muestran las pestañas. |
car_ui_toolbar_nav_icon_reserve_space |
Determina si el título se debe mover a la izquierda para ocupar el espacio del ícono de Navigation cuando este está oculto. |
car_ui_toolbar_logo_fills_nav_icon_space |
Muestra el logotipo en el mismo espacio que el botón de navegación cuando no haya un botón de navegación. |
car_ui_toolbar_show_logo |
Para inhabilitar de forma permanente la visualización de un logotipo en la barra de herramientas, configúralo en false . |
Estas vistas se muestran, ocultan o cambian según el setState
del método ToolbarControllerImpl
. Para obtener información específica sobre qué vista se muestra y cuándo, consulta ese método.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]