工具列

撥號應用程式會使用套件名稱為 com.android.car.ui.toolbar.Toolbar 的機殼工具列。自訂工具列的第一步是疊加版面配置檔案,其中 car_ui_toolbar.xmlcar_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_logocar_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 顯示、隱藏或變更。如要進一步瞭解顯示哪些檢視畫面以及何時顯示,請參閱該方法。