نماهای تند کشیدن به شما امکان میدهد بین صفحههای همسطح، مانند برگهها، با یک اشاره افقی انگشت، یا تند کشیدن، پیمایش کنید. به این الگوی پیمایش صفحهبندی افقی نیز گفته میشود.
این موضوع به شما آموزش میدهد که چگونه یک طرحبندی برگه با نماهای تند کشیدن برای جابجایی بین برگهها ایجاد کنید و چگونه یک نوار عنوان را بهجای برگهها نشان دهید.
پیادهسازی نماهای تند کشیدن
میتوانید بااستفاده از ابزاره
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 در 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، منابع اضافی زیر را ببینید.
نمونهها
- نمونههای ViewPager2 در GitHub