تتيح لك عروض التمرير السريع التنقل بين الشاشات التابعة، مثل علامات التبويب، باستخدام إيماءة إصبع أفقية (التمرير السريع). ويُشار إلى نمط التنقّل هذا أيضًا باسم التقسيم الأفقي إلى صفحات. يوضح هذا المستند كيفية إنشاء تخطيط علامات التبويب باستخدام طرق عرض التمرير للتبديل بين علامات التبويب، إلى جانب كيفية إظهار شريط عناوين بدلاً من علامات التبويب.
تطبيق عروض التمرير السريع
يمكنك إنشاء طرق عرض التمرير السريع باستخدام التطبيق المصغّر
ViewPager
في AndroidX. لاستخدام
ViewPager
وعلامات التبويب، أضِف التبعيات إلى
Viewpager
وعلى
Material
Components
في مشروعك.
لإعداد التنسيق باستخدام ViewPager
، أضِف العنصر <ViewPager>
إلى تنسيق XML. على سبيل المثال، إذا كانت كل صفحة في عرض التمرير بحاجة إلى استهلاك
التنسيق بأكمله، سيبدو تخطيطك كما يلي:
<androidx.viewpager.widget.ViewPager
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/pager"
android:layout_width="match_parent"
android:layout_height="match_parent" />
لإدراج طرق عرض فرعية تمثّل كل صفحة، أدرِج هذا التنسيق في شكل PagerAdapter
. يمكنك الاختيار من بين نوعين من المحولات المضمنة:
FragmentPagerAdapter
: استخدِم هذه السياسة عند التنقّل بين عدد صغير وثابت من الشاشات التابعة.FragmentStatePagerAdapter
: استخدِم هذا الخيار عند التنقّل بين عدد غير معروف من الصفحات. يعملFragmentStatePagerAdapter
على تحسين استخدام الذاكرة من خلال إتلاف الأجزاء أثناء انتقال المستخدم بعيدًا عنها.
إليك مثال على كيفية استخدام FragmentStatePagerAdapter
للتمرير سريعًا بين مجموعة من عناصر Fragment
:
Kotlin
class CollectionDemoFragment : Fragment() { // When requested, this adapter returns a DemoObjectFragment, representing // an object in the collection. private lateinit var demoCollectionPagerAdapter: DemoCollectionPagerAdapter private lateinit var viewPager: ViewPager override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? { return inflater.inflate(R.layout.collection_demo, container, false) } override fun onViewCreated(view: View, savedInstanceState: Bundle?) { demoCollectionPagerAdapter = DemoCollectionPagerAdapter(childFragmentManager) viewPager = view.findViewById(R.id.pager) viewPager.adapter = demoCollectionPagerAdapter } } // Since this is an object collection, use a FragmentStatePagerAdapter, not a // FragmentPagerAdapter. class DemoCollectionPagerAdapter(fm: FragmentManager) : FragmentStatePagerAdapter(fm) { override fun getCount(): Int = 100 override fun getItem(i: Int): Fragment { val fragment = DemoObjectFragment() fragment.arguments = Bundle().apply { // Our object is just an integer :-P putInt(ARG_OBJECT, i + 1) } return fragment } override fun getPageTitle(position: Int): CharSequence { return "OBJECT ${(position + 1)}" } } private const val ARG_OBJECT = "object" // Instances of this class are fragments representing a single object in your // collection. class DemoObjectFragment : Fragment() { override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View { return inflater.inflate(R.layout.fragment_collection_object, container, false) } override fun onViewCreated(view: View, savedInstanceState: Bundle?) { arguments?.takeIf { it.containsKey(ARG_OBJECT) }?.apply { val textView: TextView = view.findViewById(android.R.id.text1) textView.text = getInt(ARG_OBJECT).toString() } } }
Java
public class CollectionDemoFragment extends Fragment { // When requested, this adapter returns a DemoObjectFragment, representing // an object in the collection. DemoCollectionPagerAdapter demoCollectionPagerAdapter; ViewPager viewPager; @Nullable @Override public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) { return inflater.inflate(R.layout.collection_demo, container, false); } @Override public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) { demoCollectionPagerAdapter = new DemoCollectionPagerAdapter(getChildFragmentManager()); viewPager = view.findViewById(R.id.pager); viewPager.setAdapter(demoCollectionPagerAdapter); } } // Since this is an object collection, use a FragmentStatePagerAdapter, not a // FragmentPagerAdapter. public class DemoCollectionPagerAdapter extends FragmentStatePagerAdapter { public DemoCollectionPagerAdapter(FragmentManager fm) { super(fm); } @Override public Fragment getItem(int i) { Fragment fragment = new DemoObjectFragment(); Bundle args = new Bundle(); // Our object is just an integer. args.putInt(DemoObjectFragment.ARG_OBJECT, i + 1); fragment.setArguments(args); return fragment; } @Override public int getCount() { return 100; } @Override public CharSequence getPageTitle(int position) { return "OBJECT " + (position + 1); } } // Instances of this class are fragments representing a single object in your // collection. public class DemoObjectFragment extends Fragment { public static final String ARG_OBJECT = "object"; @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { return inflater.inflate(R.layout.fragment_collection_object, container, false); } @Override public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) { Bundle args = getArguments(); ((TextView) view.findViewById(android.R.id.text1)) .setText(Integer.toString(args.getInt(ARG_OBJECT))); } }
يوضّح القسم التالي كيفية إضافة علامات تبويب لتسهيل التنقل بين الصفحات.
إضافة علامات التبويب باستخدام TabLayout
توفّر علامة TabLayout
طريقة
لعرض علامات التبويب أفقيًا. وعند استخدام علامة TabLayout
مع ViewPager
، فإنها توفّر واجهة مألوفة للتنقّل بين الصفحات من خلال طريقة عرض التمرير السريع.
TabLayout
مع أربع
علامات تبويب.لتضمين TabLayout
في ViewPager
، أضِف العنصر <TabLayout>
داخل العنصر <ViewPager>
على النحو الموضّح في المثال التالي:
<androidx.viewpager.widget.ViewPager
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/pager"
android:layout_width="match_parent"
android:layout_height="match_parent">
<com.google.android.material.tabs.TabLayout
android:id="@+id/tab_layout"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
</androidx.viewpager.widget.ViewPager>
استخدِم setupWithViewPager()
لربط TabLayout
بالسمة ViewPager
، كما هو موضّح في المثال التالي.
تتم تعبئة علامات التبويب الفردية في TabLayout
تلقائيًا بعناوين الصفحات من PagerAdapter
.
Kotlin
class CollectionDemoFragment : Fragment() { ... override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val tabLayout = view.findViewById(R.id.tab_layout) tabLayout.setupWithViewPager(viewPager) } ... } class DemoCollectionPagerAdapter(fm: FragmentManager) : FragmentStatePagerAdapter(fm) { override fun getCount(): Int = 4 override fun getPageTitle(position: Int): CharSequence { return "OBJECT ${(position + 1)}" } ... }
Java
public class CollectionDemoFragment extends Fragment { ... @Override public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) { TabLayout tabLayout = view.findViewById(R.id.tab_layout); tabLayout.setupWithViewPager(viewPager); } ... } public class DemoCollectionPagerAdapter extends FragmentStatePagerAdapter { ... @Override public int getCount() { return 4; } @Override public CharSequence getPageTitle(int position) { return "OBJECT " + (position + 1); } ... }
للحصول على إرشادات إضافية حول التصميم لتخطيطات علامات التبويب، راجع وثائق التصميم المتعدد الأبعاد لعلامات التبويب.