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

يعرض شريط الإجراءات في أبسط صوره عنوان النشاط على أحد الجانبية وقائمة كاملة من الجانب الآخر. حتى في هذا النموذج الأساسي، يوفر شريط التطبيق معلومات مفيدة للمستخدمين ويمنح تطبيقات 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> لاستخدام أحد إطارات AppCompat NoActionBar الموضوعات، كما هو موضح في المثال التالي. يمنع استخدام أحد هذه الموضوعات تطبيق من استخدام فئة 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"/>
   

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

   ضع شريط الأدوات أعلى شاشة النشاط layout، نظرًا لأنك تستخدم كشريط تطبيق.

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()