Di chuyển từ ViewPager sang ViewPager2

ViewPager2 là phiên bản cải tiến của thư viện ViewPager, cung cấp chức năng nâng cao và giải quyết các vấn đề phổ biến khi sử dụng ViewPager. Nếu ứng dụng của bạn đã sử dụng ViewPager, hãy đọc trang này để tìm hiểu thêm về cách di chuyển sang ViewPager2.

Nếu bạn muốn sử dụng ViewPager2 trong ứng dụng và hiện không sử dụng ViewPager, hãy đọc bài viết Trượt giữa các mảnh bằng ViewPager2 và Tạo thành phần hiển thị vuốt có thẻ bằng ViewPager2 để biết thêm thông tin.

Lợi ích của việc di chuyển sang ViewPager2

Lý do chính để di chuyển là ViewPager2 đang nhận được sự hỗ trợ phát triển tích cực, còn ViewPager thì không. Tuy nhiên, ViewPager2 cũng mang lại một số lợi ích cụ thể khác.

Hỗ trợ hướng dọc

ViewPager2 hỗ trợ phân trang dọc ngoài phân trang ngang truyền thống. Bạn có thể bật tính năng phân trang dọc cho phần tử ViewPager2 bằng cách đặt thuộc tính android:orientation:

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

Bạn cũng có thể đặt thuộc tính này theo phương thức lập trình bằng cách sử dụng phương thức setOrientation().

Hỗ trợ từ phải sang trái

ViewPager2 hỗ trợ phân trang từ phải sang trái (RTL). Tính năng phân trang RTL được bật tự động khi thích hợp dựa trên ngôn ngữ, nhưng bạn cũng có thể bật tính năng phân trang RTL theo cách thủ công cho phần tử ViewPager2 bằng cách đặt thuộc tính android:layoutDirection:

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

Bạn cũng có thể đặt thuộc tính này theo phương thức lập trình bằng phương thức setLayoutDirection().

Bộ sưu tập mảnh có thể sửa đổi

ViewPager2 hỗ trợ phân trang thông qua một tập hợp mảnh có thể sửa đổi, gọi notifyDatasetChanged() để cập nhật giao diện người dùng khi tập hợp cơ bản thay đổi.

Điều này có nghĩa là ứng dụng của bạn có thể tự động sửa đổi tập hợp mảnh trong thời gian chạy và ViewPager2 sẽ hiển thị chính xác tập hợp đã sửa đổi.

DiffUtil

ViewPager2 được xây dựng trên RecyclerView, nghĩa là nó có quyền truy cập vào lớp tiện ích DiffUtil. Điều này mang lại một số lợi ích, nhưng đáng chú ý nhất là các đối tượng ViewPager2 sẽ tận dụng ảnh động thay đổi tập dữ liệu từ lớp RecyclerView.

Di chuyển ứng dụng sang ViewPager2

Làm theo các bước sau để cập nhật các đối tượng ViewPager trong ứng dụng của bạn thành ViewPager2:

Cập nhật tệp bố cục XML

Trước tiên, hãy thay thế các phần tử ViewPager trong tệp bố cục XML bằng các phần tử ViewPager2:

<!-- A ViewPager element -->
<android.support.v4.view.ViewPager
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

<!-- A ViewPager2 element -->
<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" />

Cập nhật các lớp bộ chuyển đổi

Khi sử dụng ViewPager, bạn phải mở rộng lớp bộ chuyển đổi cung cấp các trang mới cho đối tượng. Tuỳ thuộc vào trường hợp sử dụng, ViewPager đã sử dụng ba lớp trừu tượng khác nhau. ViewPager2 chỉ sử dụng hai lớp trừu tượng.

Đối với mỗi đối tượng ViewPager mà bạn đang chuyển đổi thành đối tượng ViewPager2, hãy cập nhật lớp bộ chuyển đổi để mở rộng lớp trừu tượng thích hợp như sau:

Tham số hàm khởi tạo

Các lớp bộ chuyển đổi dựa trên mảnh kế thừa từ FragmentPagerAdapter hoặc FragmentStatePagerAdapter luôn chấp nhận một đối tượng FragmentManager làm tham số hàm khởi tạo. Khi mở rộng FragmentStateAdapter cho một lớp bộ chuyển đổi ViewPager2, bạn có các lựa chọn sau đây cho tham số hàm khởi tạo:

  • Đối tượng FragmentActivity hoặc đối tượng Fragment chứa đối tượng ViewPager2. Trong hầu hết các trường hợp, đây là lựa chọn phù hợp hơn.
  • Một đối tượng FragmentManager và một đối tượng Lifecycle.

Các lớp bộ chuyển đổi dựa trên khung hiển thị kế thừa trực tiếp từ RecyclerView.Adapter không yêu cầu tham số hàm khởi tạo.

Phương thức ghi đè

Các lớp bộ chuyển đổi cũng cần ghi đè các phương thức cho ViewPager2 khác với các phương thức cho ViewPager:

  • Thay vì getCount(), hãy ghi đè getItemCount(). Ngoài tên, phương thức này không thay đổi.
  • Thay vì getItem(), hãy ghi đè createFragment() trong các lớp bộ chuyển đổi dựa trên mảnh. Đảm bảo rằng phương thức createFragment() mới luôn cung cấp một thực thể mảnh mới mỗi khi hàm được gọi thay vì sử dụng lại các thực thể.

Tóm tắt

Tóm lại, để chuyển đổi một lớp bộ chuyển đổi ViewPager để sử dụng với ViewPager2, bạn phải thực hiện các thay đổi sau:

  1. Thay đổi lớp cha thành RecyclerView.Adapter để phân trang thông qua các khung hiển thị hoặc FragmentStateAdapter để phân trang thông qua các mảnh.
  2. Thay đổi các tham số hàm khởi tạo trong các lớp bộ chuyển đổi dựa trên mảnh.
  3. Ghi đè getItemCount() thay vì getCount().
  4. Ghi đè createFragment() thay vì getItem() trong các lớp bộ chuyển đổi dựa trên mảnh.

Kotlin

// A simple ViewPager adapter class for paging through fragments
class ScreenSlidePagerAdapter(fm: FragmentManager) : FragmentStatePagerAdapter(fm) {
    override fun getCount(): Int = NUM_PAGES

    override fun getItem(position: Int): Fragment = ScreenSlidePageFragment()
}

// An equivalent ViewPager2 adapter class
class ScreenSlidePagerAdapter(fa: FragmentActivity) : FragmentStateAdapter(fa) {
    override fun getItemCount(): Int = NUM_PAGES

    override fun createFragment(position: Int): Fragment = ScreenSlidePageFragment()
}

Java

// A simple ViewPager adapter class for paging through fragments
public class ScreenSlidePagerAdapter extends FragmentStatePagerAdapter {
    public ScreenSlidePagerAdapter(FragmentManager fm) {
        super(fm);
    }

    @Override
    public Fragment getItem(int position) {
        return new ScreenSlidePageFragment();
    }

    @Override
    public int getCount() {
        return NUM_PAGES;
    }
}

// An equivalent ViewPager2 adapter class
private class ScreenSlidePagerAdapter extends FragmentStateAdapter {
    public ScreenSlidePagerAdapter(FragmentActivity fa) {
        super(fa);
    }

    @Override
    public Fragment createFragment(int position) {
        return new ScreenSlidePageFragment();
    }

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

Tái cấu trúc giao diện TabLayout

ViewPager2 đưa ra những thay đổi đối với việc tích hợp TabLayout. Nếu hiện đang sử dụng ViewPager với đối tượng TabLayout để hiển thị các thẻ ngang cho thao tác điều hướng, bạn cần tái cấu trúc đối tượng TabLayout để tích hợp với ViewPager2.

TabLayout đã được tách khỏi ViewPager2 và hiện có sẵn dưới dạng một phần của Thành phần Material. Điều này có nghĩa là để sử dụng, bạn cần thêm phần phụ thuộc thích hợp vào tệp build.gradle:

Groovy

implementation "com.google.android.material:material:1.1.0-beta01"

Kotlin

implementation("com.google.android.material:material:1.1.0-beta01")

Bạn cũng cần thay đổi vị trí của phần tử TabLayout trong hệ phân cấp của tệp bố cục XML. Với ViewPager, phần tử TabLayout được khai báo là phần tử con của phần tử ViewPager; nhưng với ViewPager2, phần tử TabLayout được khai báo ngay phía trên phần tử ViewPager2, ở cùng cấp:

<!-- A ViewPager element with a TabLayout -->
<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>

<!-- A ViewPager2 element with a TabLayout -->
<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>

Cuối cùng, bạn phải cập nhật mã đính kèm đối tượng TabLayout vào đối tượng ViewPager. Mặc dù TabLayout sử dụng phương thức setupWithViewPager() riêng để tích hợp với ViewPager, nhưng cần có một thực thể TabLayoutMediator để tích hợp với ViewPager2.

Đối tượng TabLayoutMediator cũng xử lý nhiệm vụ tạo tiêu đề trang cho đối tượng TabLayout, tức là lớp bộ chuyển đổi không cần ghi đè getPageTitle():

Kotlin

// Integrating TabLayout with ViewPager
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)}"
    }
    ...
}

// Integrating TabLayout with 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()
    }
    ...
}

Java

// Integrating TabLayout with ViewPager
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);
    }
    ...
}

// Integrating TabLayout with ViewPager2
public class CollectionDemoFragment : 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();
    }
    ...
}

Hỗ trợ các phần tử có thể cuộn lồng nhau

ViewPager2 không hỗ trợ sẵn các chế độ xem cuộn lồng nhau trong trường hợp chế độ xem cuộn có cùng hướng với đối tượng ViewPager2 chứa chế độ xem đó. Ví dụ: thao tác cuộn sẽ không hoạt động đối với chế độ xem cuộn dọc bên trong đối tượng ViewPager2 theo hướng dọc.

Để hỗ trợ chế độ xem cuộn bên trong đối tượng ViewPager2 có cùng hướng, bạn phải gọi requestDisallowInterceptTouchEvent() trên đối tượng ViewPager2 khi muốn cuộn phần tử lồng nhau. Mẫu cuộn lồng nhau ViewPager2 minh hoạ một cách giải quyết vấn đề này bằng bố cục trình bao bọc tuỳ chỉnh linh hoạt.

Tài nguyên khác

Để tìm hiểu thêm về ViewPager2, hãy xem các tài nguyên bổ sung sau đây.

Video