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

تجربة طريقة الإنشاء

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

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

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

الشكل 1. شريط تطبيقات مع رمز إجراء في تطبيق "Now in 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);
   }
   

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

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

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

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