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

تجربة طريقة "الكتابة"

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

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

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

الشكل 1. شريط تطبيقات يتضمّن رمز إجراء في تطبيق "الآن في Android".

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

من ناحية أخرى، تتم إضافة ميزات إلى إصدار Toolbar من مكتبة AndroidX AppCompat، ما يعني أنّ هذه الميزات تتوفّر على الأجهزة التي تستخدم مكتبات 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() الخاصة بالنشاط. يعرض هذا الإجراء مرجعًا إلى عنصر ActionBar من AppCompat. بعد الحصول على هذا المرجع، يمكنك استدعاء أي من طرق ActionBar لتعديل شريط التطبيق. على سبيل المثال، لإخفاء شريط التطبيق، استخدِم الرمز ActionBar.hide().