تُستخدم ViewPager في تطبيقات Android لعرض مجموعة من الشاشات أو الصفحات في صورة متسلسلة. ويمكن استخدامه كعنصر واجهة المستخدم الرئيسي في تطبيقات Android مثل التطبيقات الإخبارية أو التطبيقات الرياضية أو التطبيقات الاجتماعية. ولتحقيق ذلك، يمكن اتباع الخطوات التالية:
1. إضافة مكتبة الدعم
ViewPager موجود في مكتبة الدعم، لذلك يجب إضافة مكتبة الدعم إلى ملف gradle.build الخاص بالتطبيق. يمكن القيام بذلك عن طريق إضافة التالي في ملف gradle.build الخاص بالتطبيق:
“`
dependencies {
implementation ‘com.android.support:support-v4:28.0.0’
}
“`
2. تحضير الـ layout
بعد إضافة مكتبة الدعم، يمكن إعداد الـ layout الخاص بـ ViewPager. على سبيل المثال، يمكن إنشاء ملف layout بالاسم “activity_main.xml” وإضافة ViewPager إليه كما يلي:
“`
android:layout_height=”match_parent”
android:orientation=”vertical”>
android:layout_width=”match_parent”
android:layout_height=”match_parent” />
“`
3. تحضير Adapter
يجب إنشاء Adapter لـ ViewPager لإضافة الصفحات التي ستظهر داخله. يمكن استخدام FragmentPagerAdapter أو FragmentStatePagerAdapter. يتم تمرير Adapter إلى ViewPager عن طريق الكود. على سبيل المثال، يمكن إنشاء Adapter بالاسم “MyPagerAdapter” وإضافة الصفحات إليه كما يلي:
“`
public class MyPagerAdapter extends FragmentPagerAdapter {
private static final int NUM_PAGES = 3;
public MyPagerAdapter(FragmentManager fm) {
super(fm);
}
@Override
public Fragment getItem(int position) {
switch (position) {
case 0:
return new Page1Fragment();
case 1:
return new Page2Fragment();
case 2:
return new Page3Fragment();
default:
return null;
}
}
@Override
public int getCount() {
return NUM_PAGES;
}
}
“`
في المثال أعلاه، يتم تمرير FragmentManager إلى Adapter ويتم إنشاء 3 صفحات باستخدام getItem()، ويتم إعادة الـ Fragment المطلوب لكل صفحة. يتم تمرير عدد الصفحات إلى getCount().
4. ربط Adapter بـ ViewPager
بعد إنشاء Adapter، يجب ربطه بـ ViewPager. يمكن ذلك في الكود، وعلى سبيل المثال، يمكن استخدام الكود التالي:
“`
ViewPager viewPager = findViewById(R.id.view_pager);
MyPagerAdapter adapter = new MyPagerAdapter(getSupportFragmentManager());
viewPager.setAdapter(adapter);
“`
5. إضافة أزرار التحكم في ViewPager (اختياري)
يمكن إضافة أزرار التحكم في ViewPager لتمكين المستخدمين من التنقل بين الصفحات. يمكن إضافة الأزرار في الـ layout والتعامل معها في الكود. وعلى سبيل المثال، يمكن إضافة أزرار “التالي” و “السابق” كما يلي:
“`
android:layout_width=”wrap_content”
android:layout_height=”wrap_content”
android:text=”Prev” />
android:layout_width=”wrap_content”
android:layout_height=”wrap_content”
android:text=”Next” />
“`
ومن ثم، يمكن التعامل مع الأزرار في الـ onCreate() كما يلي:
“`
Button prevButton = findViewById(R.id.prev_button);
prevButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
viewPager.setCurrentItem(viewPager.getCurrentItem() – 1);
}
});
Button nextButton = findViewById(R.id.next_button);
nextButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
viewPager.setCurrentItem(viewPager.getCurrentItem() + 1);
}
});
“`
في المثال أعلاه، يتم جلب الأزرار في الـ layout وتعيين مستمعي الحدث onClick() لهما. تم تعيين المستمع للأزرار لتحديد الصفحة التالية أو السابقة باستخدام setCurrentItem().
