Google is committed to advancing racial equity for Black communities. See how.

Toolbar

Dialer uses the chassis toolbar with a package name of com.android.car.ui.toolbar.Toolbar. The first step to customizing the toolbar is to overlay the layout file, which is car_ui_toolbar.xml and car_ui_toolbar_two_row.xml for the legacy toolbar, and car_ui_base_layout_toolbar.xml for the base layout version. In each version of the layout, each of the following views must be provided with the respective ids:

id View type Description
car_ui_toolbar_background/td> android.view.View Deprecated for base layouts, but used with the previous toolbar style to determine height.
car_ui_toolbar_tabs com.android.car.ui.toolbar.TabLayout Location of tabs.
car_ui_toolbar_nav_icon android.widget.ImageView The Back, Close, Down button.
car_ui_toolbar_logo android.widget.ImageView The logo, when car_ui_toolbar_logo_
fills_nav_icon_space is true.
car_ui_toolbar_nav_icon_container android.view.ViewGroup A container to hold car_ui_toolbar_logo and car_ui_toolbar_nav_icon.
car_ui_toolbar_menu_items_container android.view.ViewGroup A ViewGroup to contain MenuItems.
car_ui_toolbar_title android.widget.TextView The title of the toolbar.
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.
car_ui_toolbar_title_logo android.widget.ImageView The logo, when car_ui_toolbar_logo_
fills_nav_icon_space is false
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.
car_ui_toolbar_progress_bar android.widget.ProgressBar A progress bar.

Next, you must also customize car_ui_toolbar_search_view.xml, which contains the Search bar, which must have the following views:

id View type Description
car_ui_toolbar_search_bar android.widget.EditText The EditText where the user types text to search.
car_ui_toolbar_search_icon android.widget.ImageView An icon, that normally shows a search icon but can be changed by applications.
car_ui_toolbar_search_close android.view.View A view that when clicked will clear the search box

In addition to the layout, you can use these Boolean attributes to customize the toolbar:

Attribute Description
car_ui_toolbar_tabs_on_second_row Determines whether or not to hide the title when tabs are displayed.
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.
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.
car_ui_toolbar_show_logo To permanently disable the display of a logo in the toolbar, set this to false.

These views are displayed, hidden, or changed based on the setState of the ToolbarControllerImpl method. For specifics about which view is displayed and when, see that method.