ضبط شريط التطبيق

تجربة طريقة ComposeAllowed

Jetpack Compose هي مجموعة أدوات واجهة المستخدم التي ننصح بها لنظام التشغيل Android. تعرَّف على كيفية إضافة مكونات في Compose.

شريط التطبيقات →

في أبسط صوره، يعرض شريط الإجراءات عنوان النشاط من جانب والقائمة الكاملة من جانب آخر. حتى في هذا الشكل الأساسي، يوفر شريط التطبيق معلومات مفيدة للمستخدمين ويمنح تطبيقات Android مظهرًا وأسلوبًا متسقين.

الشكل 1. شريط تطبيق يحتوي على رمز إجراء في تطبيق "الآن في Android".

تتضمن جميع الأنشطة التي تستخدم المظهر التلقائي ActionBar كشريط تطبيق. تتم إضافة ميزات شريط التطبيقات إلى إصدار ActionBar الأصلي عبر إصدارات مختلفة من Android. ونتيجةً لذلك، يختلف أداء إصدار ActionBar الأصلي بناءً على إصدار Android الذي يستخدمه الجهاز.

من ناحية أخرى، تُضاف الميزات إلى إصدار مكتبة AndroidX AppCompat من Toolbar، ما يعني أنّ هذه الميزات متوفرة على الأجهزة التي تستخدم مكتبات AndroidX.

استخدم الفئة Toolbar في مكتبة AndroidX لتنفيذ أشرطة تطبيقات أنشطتك لهذا السبب. يؤدي استخدام شريط أدوات مكتبة AndroidX إلى اتساق سلوك تطبيقك عبر أوسع مجموعة من الأجهزة.

إضافة شريط أدوات إلى نشاط

توضِّح الخطوات التالية كيفية إعداد "Toolbar" كشريط تطبيقات لنشاطك:

1. أضِف مكتبة AndroidX إلى مشروعك، كما هو موضّح في نظرة عامة على AndroidX.
2. تأكَّد من أنّ النشاط يمتد إلى AppCompatActivity:

   Kotlin

   class MyActivity : AppCompatActivity() {
     // ...
   }
   

   Java

   public class MyActivity extends AppCompatActivity {
     // ...
   }
   

   ملاحظة: يجب إجراء هذا التغيير لكل نشاط في تطبيقك يستخدم Toolbar كشريط تطبيقات.
3. في بيان التطبيق، اضبط العنصر <application> لاستخدام أحد مظاهر NoActionBar في AppCompat، كما هو موضَّح في المثال التالي. يؤدي استخدام أحد هذه المظاهر إلى منع التطبيق من استخدام فئة ActionBar الأصلية لتوفير شريط التطبيقات.

   <application
       android:theme="@style/Theme.AppCompat.Light.NoActionBar"
       />
   

4. أضِف Toolbar إلى تنسيق النشاط. على سبيل المثال، يضيف رمز التنسيق التالي Toolbar ويجعله يبدو عائمًا فوق النشاط:

   <androidx.appcompat.widget.Toolbar
      android:id="@+id/my_toolbar"
      android:layout_width="match_parent"
      android:layout_height="?attr/actionBarSize"
      android:background="?attr/colorPrimary"
      android:elevation="4dp"
      android:theme="@style/ThemeOverlay.AppCompat.ActionBar"
      app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>
   

   يمكنك الاطّلاع على مواصفات التصميم المتعدد الأبعاد للحصول على اقتراحات بشأن ارتفاع شريط التطبيق.

   ضع شريط الأدوات أعلى تنسيق النشاط، بما أنّك تستخدمه كشريط تطبيقات.

5. في طريقة onCreate() الخاصة بالنشاط، يمكنك استدعاء طريقة setSupportActionBar() للنشاط وتمرير شريط أدوات النشاط، كما هو موضّح في المثال التالي. تضبط هذه الطريقة شريط الأدوات على أنّه شريط التطبيق للنشاط.

   Kotlin

   override fun onCreate(savedInstanceState: Bundle?) {
       super.onCreate(savedInstanceState)
       setContentView(R.layout.activity_my)
       // The Toolbar defined in the layout has the id "my_toolbar".
       setSupportActionBar(findViewById(R.id.my_toolbar))
   }
   

   Java

   @Override
   protected void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.activity_my);
       Toolbar myToolbar = (Toolbar) findViewById(R.id.my_toolbar);
       setSupportActionBar(myToolbar);
   }
   

يحتوي تطبيقك الآن على شريط إجراءات أساسي. يحتوي شريط الإجراءات افتراضيًا على اسم التطبيق وقائمة كاملة تحتوي في الأساس على عنصر الإعدادات. يمكنك إضافة المزيد من الإجراءات إلى شريط الإجراءات والقائمة الكاملة، كما هو موضّح في إضافة الإجراءات والتعامل معها.

استخدام طرق أداة شريط التطبيقات

بعد ضبط شريط الأدوات كشريط تطبيقات النشاط، ستتمكّن من الوصول إلى طرق الأداة المساعدة التي تقدّمها فئة مكتبة AndroidX ActionBar. تتيح لك هذه الطريقة تنفيذ إجراءات مفيدة، مثل إخفاء شريط التطبيقات وإظهاره.

لاستخدام طرق الأداة ActionBar، يمكنك استدعاء طريقة getSupportActionBar() للنشاط. تعرض هذه الطريقة مرجعًا إلى كائن AppCompat ActionBar. بعد الحصول على هذا المرجع، يمكنك استدعاء أي من طرق ActionBar لضبط شريط التطبيق. على سبيل المثال، لإخفاء شريط التطبيقات، يمكنك طلب ActionBar.hide().