Pratinjau Developer Android 11 kedua kini tersedia, uji dan sampaikan masukan Anda.

Membuat tampilan geser dengan tab menggunakan ViewPager

Dengan tampilan geser, Anda dapat melakukan navigasi antara layar yang setara, seperti tab, dengan gestur jari horizontal, atau gestur geser. Pola navigasi ini juga disebut sebagai penentuan halaman horizontal. Topik ini menunjukkan cara membuat tata letak tab dengan tampilan geser untuk beralih antara tab, serta cara menampilkan strip judul, bukan tab.

Menerapkan Tampilan Geser

Anda dapat membuat tampilan geser menggunakan widget ViewPager AndroidX. Untuk menggunakan ViewPager dan tab, Anda perlu menambahkan dependensi pada ViewPager dan Komponen Material ke project.

Untuk menyiapkan tata letak dengan ViewPager, tambahkan elemen <ViewPager> ke tata letak XML Anda. Misalnya, jika setiap halaman di tampilan geser harus menggunakan seluruh tata letak, tata letak Anda akan terlihat seperti ini:

<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" />
    

Untuk memasukkan tampilan turunan yang mewakili setiap halaman, Anda harus menarik tata letak ini ke PagerAdapter. Anda dapat memilih antara dua jenis adaptor bawaan:

  • FragmentPagerAdapter - Gunakan adaptor ini saat melakukan navigasi antara layar setara yang tetap dalam jumlah kecil.
  • FragmentStatePagerAdapter - Gunakan adaptor ini saat melakukan penentuan halaman pada halaman yang yang tidak diketahui jumlahnya. FragmentStatePagerAdapter mengoptimalkan penggunaan memori dengan mengakhiri fragmen saat pengguna menutupnya.

Contohnya, berikut adalah cara menggunakan FragmentStatePagerAdapter untuk menggeser kumpulan objek 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,
    // and 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 our 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,
    // and 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 :-P
            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 our 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)));
        }
    }
    

Bagian berikut menunjukkan cara menambahkan tab untuk memudahkan navigasi antara halaman.

Menambahkan Tab Menggunakan TabLayout

TabLayout memberikan cara untuk menampilkan tab secara horizontal. Jika digunakan bersama dengan ViewPager, TabLayout dapat memberikan antarmuka yang umum untuk melakukan navigasi antara halaman dalam tampilan geser.

Gambar 1: TabLayout dengan empat tab.

Untuk menyertakan TabLayout dalam ViewPager, tambahkan elemen <TabLayout> di dalam elemen <ViewPager>, seperti yang ditunjukkan di bawah ini:

<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>
    

Selanjutnya, gunakan setupWithViewPager() untuk menautkan TabLayout ke ViewPager. Setiap tab dalam TabLayout secara otomatis diisi dengan judul halaman dari 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);
        }

        ...
    }
    

Untuk panduan desain tata letak tab lainnya, lihat Dokumentasi Desain Material untuk tab.