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

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

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

صورة تعرض شريط التطبيق في تطبيق Now في 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 {
      // ...
    }
    
  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().