في أبسط أشكاله، يعرض شريط الإجراءات عنوان النشاط على أحد الجانبين وقائمة كاملة على الجانب الآخر. حتى في هذا الشكل الأساسي، يوفر شريط التطبيق معلومات مفيدة للمستخدمين ويمنح تطبيقات Android مظهرًا وأسلوبًا متسقًا.
تحتوي جميع الأنشطة التي تستخدم المظهر التلقائي على
ActionBar
كشريط تطبيقات. تتم إضافة ميزات شريط التطبيق إلى ActionBar
الأصلي عبر إصدارات Android المختلفة. ونتيجةً لذلك، يختلف سلوك ActionBar
الأصلي
اعتمادًا على إصدار Android الذي يستخدمه الجهاز.
من ناحية أخرى، تتم إضافة ميزات إلى إصدار مكتبة AndroidX AppCompat لـ
Toolbar
،
مما يعني أن هذه الميزات تتوفر على الأجهزة التي تستخدم مكتبات AndroidX.
لهذا السبب، يمكنك استخدام الفئة Toolbar
في مكتبة AndroidX لتنفيذ أشرطة التطبيقات الخاصة بأنشطتك. يؤدي استخدام شريط أدوات مكتبة AndroidX إلى جعل سلوك
التطبيق متسقًا على نطاق واسع من الأجهزة.
إضافة شريط أدوات إلى نشاط
توضِّح الخطوات التالية كيفية إعداد "Toolbar
" كشريط تطبيقات لنشاطك:
- أضِف مكتبة AndroidX إلى مشروعك، كما هو موضَّح في نظرة عامة على AndroidX.
- تأكَّد من أنّ النشاط يمتد إلى
"
AppCompatActivity
":Kotlin
class MyActivity : AppCompatActivity() { // ... }
Java
public class MyActivity extends AppCompatActivity { // ... }
- في بيان التطبيق، اضبط العنصر
<application>
لاستخدام أحد مظاهرNoActionBar
من AppCompat، كما هو موضّح في المثال التالي. ويؤدّي استخدام أحد هذه المظاهر إلى منع التطبيق من استخدام الفئةActionBar
الأصلية لتوفير شريط التطبيقات.<application android:theme="@style/Theme.AppCompat.Light.NoActionBar" />
- أضِف
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"/>
راجِع مواصفات التصميم المتعدد الأبعاد للحصول على اقتراحات بشأن ارتفاع شريط التطبيق.
ضَع شريط الأدوات في أعلى تنسيق النشاط لأنّك تستخدمه في شريط التطبيقات.
- في طريقة
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()
.