A partir de 27 de março de 2025, recomendamos usar android-latest-release
em vez de aosp-main
para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Barra de ferramentas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O discador usa a barra de ferramentas do chassi com o nome de pacote
com.android.car.ui.toolbar.Toolbar
.
A primeira etapa para personalizar a barra de ferramentas é sobrepor o arquivo de layout, que é
car_ui_toolbar.xml
e car_ui_toolbar_two_row.xml
para a barra de ferramentas legada
e car_ui_base_layout_toolbar.xml
para a versão de layout base. Em cada versão do
layout, cada uma das visualizações a seguir precisa ser fornecida com os respectivos IDs:
id |
Tipo de visualização |
Descrição |
car_ui_toolbar_background /td>
| android.view.View |
Descontinuado para layouts básicos, mas usado com o estilo de barra de ferramentas anterior para determinar a altura. |
car_ui_toolbar_tabs |
com.android.car.ui.toolbar.TabLayout |
Local das guias. |
car_ui_toolbar_nav_icon |
android.widget.ImageView |
Botão "Voltar", "Fechar", "Para baixo". |
car_ui_toolbar_logo |
android.widget.ImageView |
O logotipo, quando car_ui_toolbar_logo_ fills_nav_icon_space é true . |
car_ui_toolbar_nav_icon_container |
android.view.ViewGroup |
Um contêiner para car_ui_toolbar_logo e car_ui_toolbar_nav_icon . |
car_ui_toolbar_menu_items_container |
android.view.ViewGroup |
Um ViewGroup para conter MenuItems. |
car_ui_toolbar_title |
android.widget.TextView |
O título da barra de ferramentas. |
car_ui_toolbar_title_logo_container |
android.view.ViewGroup |
Um contêiner para o car_ui_toolbar_title_logo . O contêiner será mostrado (ou
oculto) em vez da ImageView. |
car_ui_toolbar_title_logo |
android.widget.ImageView |
O logotipo, quando car_ui_toolbar_logo_ fills_nav_icon_space é false |
car_ui_toolbar_search_view_container |
android.widget.FrameLayout |
Um contêiner em que a visualização de pesquisa será inflada. Isso reduz a duração da inflação em
telas sem barras de pesquisa. |
car_ui_toolbar_progress_bar |
android.widget.ProgressBar |
Uma barra de progresso. |
Em seguida, você também precisa personalizar car_ui_toolbar_search_view.xml
, que contém a
barra de pesquisa, que precisa ter as seguintes visualizações:
id |
Tipo de visualização |
Descrição |
car_ui_toolbar_search_bar |
android.widget.EditText |
O EditText em que o usuário digita o texto para pesquisar. |
car_ui_toolbar_search_icon |
android.widget.ImageView |
Um ícone que normalmente mostra um ícone de pesquisa, mas pode ser alterado por aplicativos. |
car_ui_toolbar_search_close |
android.view.View |
Uma visualização que, ao clicar, limpa a caixa de pesquisa |
Além do layout, você pode usar estes atributos booleanos para personalizar a barra de ferramentas:
Atributo |
Descrição |
car_ui_toolbar_tabs_on_second_row |
Determina se o título será ocultado ou não quando as guias forem exibidas. |
car_ui_toolbar_nav_icon_reserve_space |
Determina se o título precisa ser movido para a esquerda para ocupar o espaço do ícone de navegação
quando ele está oculto. |
car_ui_toolbar_logo_fills_nav_icon_space |
Mostrar o logotipo no mesmo espaço do botão de navegação quando nenhum botão de navegação estiver
presente. |
car_ui_toolbar_show_logo |
Para desativar permanentemente a exibição de um logotipo na barra de ferramentas, defina como false . |
Essas visualizações são mostradas, ocultas ou alteradas com base no setState
do
método ToolbarControllerImpl
. Para saber mais sobre qual visualização é mostrada e quando,
consulte esse método.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]