ایجاد نماهای تند کشیدن با زبانه‌ها بااستفاده از ViewPager2

نماهای تند کشیدن به شما امکان می‌دهد بین صفحه‌های هم‌سطح، مانند برگه‌ها، با یک اشاره افقی انگشت، یا تند کشیدن، پیمایش کنید. به این الگوی پیمایش صفحه‌بندی افقی نیز گفته می‌شود.

این موضوع به شما آموزش می‌دهد که چگونه یک طرح‌بندی برگه با نماهای تند کشیدن برای جابجایی بین برگه‌ها ایجاد کنید و چگونه یک نوار عنوان را به‌جای برگه‌ها نشان دهید.

پیاده‌سازی نماهای تند کشیدن

می‌توانید بااستفاده از ابزاره ViewPager2 AndroidX، نماهای تند کشیدن ایجاد کنید. برای استفاده از ViewPager2 و برگه‌ها، باید وابستگی به ViewPager2 و Material Components را به پروژه‌تان اضافه کنید.

برای راه‌اندازی چیدمان با ViewPager2، عنصر <ViewPager2> را به چیدمان XML اضافه کنید. برای مثال، اگر هر صفحه در نمای تند کشیدن کل چیدمان را مصرف کند، چیدمان شما به این شکل خواهد بود:

<androidx.viewpager2.widget.ViewPager2
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

برای درج نماهای فرزند که هر صفحه را نشان می‌دهد، این چیدمان را به FragmentStateAdapter متصل کنید. در اینجا نحوه استفاده از آن برای تند کشیدن در مجموعه‌ای از اشیای Fragment آورده شده است:

کاتلین

class CollectionDemoFragment : Fragment() {
    // When requested, this adapter returns a DemoObjectFragment,
    // representing an object in the collection.
    private lateinit var demoCollectionAdapter: DemoCollectionAdapter
    private lateinit var viewPager: ViewPager2

    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?) {
        demoCollectionAdapter = DemoCollectionAdapter(this)
        viewPager = view.findViewById(R.id.pager)
        viewPager.adapter = demoCollectionAdapter
    }
}

class DemoCollectionAdapter(fragment: Fragment) : FragmentStateAdapter(fragment) {

    override fun getItemCount(): Int = 100

    override fun createFragment(position: Int): Fragment {
        // Return a NEW fragment instance in createFragment(int).
        val fragment = DemoObjectFragment()
        fragment.arguments = Bundle().apply {
            // The object is just an integer.
            putInt(ARG_OBJECT, position + 1)
        }
        return fragment
    }
}

private const val ARG_OBJECT = "object"

// Instances of this class are fragments representing a single
// object in the 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()
        }
    }
}

جاوا

public class CollectionDemoFragment extends Fragment {
    // When requested, this adapter returns a DemoObjectFragment,
    // representing an object in the collection.
    DemoCollectionAdapter demoCollectionAdapter;
    ViewPager2 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) {
        demoCollectionAdapter = new DemoCollectionAdapter(this);
        viewPager = view.findViewById(R.id.pager);
        viewPager.setAdapter(demoCollectionAdapter);
    }
}

public class DemoCollectionAdapter extends FragmentStateAdapter {
    public DemoCollectionAdapter(Fragment fragment) {
        super(fragment);
    }

    @NonNull
    @Override
    public Fragment createFragment(int position) {
        // Return a NEW fragment instance in createFragment(int).
        Fragment fragment = new DemoObjectFragment();
        Bundle args = new Bundle();
        // The object is just an integer.
        args.putInt(DemoObjectFragment.ARG_OBJECT, position + 1);
        fragment.setArguments(args);
        return fragment;
    }

    @Override
    public int getItemCount() {
        return 100;
    }
}

// Instances of this class are fragments representing a single
// object in the collection.
public class DemoObjectFragment extends Fragment {
    public static final String ARG_OBJECT = "object";

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
            @Nullable 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 همراه با ViewPager2 استفاده شود، می‌تواند میانای آشنایی برای پیمایش بین صفحه‌ها در نمای تند کشیدن ارائه دهد.

تصویری که TabLayout را با چهار برگه نشان می‌دهد و برگه سوم انتخاب شده است.
شکل ۱. یک TabLayout با چهار برگه.

برای گنجاندن TabLayout در ViewPager2، عنصر <TabLayout> را بالای عنصر <ViewPager2> اضافه کنید:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <com.google.android.material.tabs.TabLayout
        android:id="@+id/tab_layout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <androidx.viewpager2.widget.ViewPager2
        android:id="@+id/pager"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" />

</LinearLayout>

سپس، TabLayoutMediator ایجاد کنید تا TabLayout را به ViewPager2 پیوند دهید و آن را به‌صورت زیر پیوست کنید:

کاتلین

class CollectionDemoFragment : Fragment() {
    ...
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        val tabLayout = view.findViewById(R.id.tab_layout)
        TabLayoutMediator(tabLayout, viewPager) { tab, position ->
            tab.text = "OBJECT ${(position + 1)}"
        }.attach()
    }
    ...
}

جاوا

public class CollectionDemoFragment extends Fragment {
    ...
    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        TabLayout tabLayout = view.findViewById(R.id.tab_layout);
        new TabLayoutMediator(tabLayout, viewPager,
                (tab, position) -> tab.setText("OBJECT " + (position + 1))
        ).attach();
    }
    ...
}

برای راهنمایی بیشتر درباره طراحی چیدمان‌های برگه‌ای، به اسناد طراحی مواد برای برگه‌ها مراجعه کنید.

منابع بیشتر

برای کسب اطلاعات بیشتر درباره ViewPager2، منابع اضافی زیر را ببینید.

نمونه‌ها

ویدیوها