اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
شريط الأدوات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يستخدم تطبيق "أداة الاتصال" شريط أدوات الهيكل الذي يحمل اسم الحزمة
com.android.car.ui.toolbar.Toolbar.
تتمثل الخطوة الأولى لتخصيص شريط الأدوات في تراكب ملف التنسيق، وهو ملف car_ui_toolbar.xml وcar_ui_toolbar_two_row.xml لشريط الأدوات القديم،
وcar_ui_base_layout_toolbar.xml لإصدار التنسيق الأساسي. في كل إصدار من
التنسيق، يجب تزويد كل عرض من العروض التالية بالمعرّفات ذات الصلة:
| 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 |
مجموعة عناصر عرض تحتوي على عناصر قائمة الطعام |
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. |
يتم عرض طرق العرض هذه أو إخفاؤها أو تغييرها استنادًا إلى setState من ToolbarControllerImpl. للاطّلاع على تفاصيل حول طريقة عرض البيانات وحالات عرضها،
راجِع هذه الطريقة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]
