Ya está disponible la segunda Vista previa para desarrolladores de Android 11; pruébala y comparte tus comentarios.

Cómo crear vistas deslizantes con pestañas mediante ViewPager

Las vistas deslizantes te permiten navegar entre pantallas relacionadas, como pestañas, con un gesto horizontal del dedo o un deslizamiento. Este patrón de navegación también se conoce como paginación horizontal. En este tema, se explica cómo crear un diseño de pestaña con deslizamiento para alternar entre pestañas, además de cómo mostrar una tira de título en lugar de pestañas.

Cómo implementar vistas deslizantes

Puedes crear vistas deslizantes con el widget ViewPager de AndroidX. Para usar ViewPager y pestañas, debes agregar una dependencia en ViewPager y en Componentes materiales a tu proyecto.

Para configurar tu diseño con ViewPager, agrega el elemento <ViewPager> a tu diseño XML. Por ejemplo, si cada página de la vista deslizante debe consumir todo el diseño, este debería verse de la siguiente manera:

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

Para insertar vistas secundarias que representen cada página, debes conectar este diseño a un PagerAdapter. Puedes elegir entre los siguientes dos tipos de adaptadores integrados:

  • FragmentPagerAdapter: Úsalo cuando navegues entre una pequeña cantidad fija de pantallas relacionadas.
  • FragmentStatePagerAdapter: Úsalo cuando realices la paginación en una cantidad desconocida de páginas. FragmentStatePagerAdapter optimiza el uso de memoria gracias a que destruye fragmentos a medida que el usuario se aleja.

A modo de ejemplo, así es como puedes usar FragmentStatePagerAdapter para deslizarte a través de una colección de objetos 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)));
        }
    }
    

Las siguientes secciones muestran cómo puedes agregar pestañas para ayudar a facilitar la navegación entre páginas.

Cómo agregar pestañas con un objeto TabLayout

Un objeto TabLayout proporciona una forma de mostrar pestañas horizontalmente. Cuando se usa junto con un ViewPager, un TabLayout puede proporcionar una interfaz familiar para navegar entre páginas en una vista deslizante.

Figura 1: Un TabLayout con cuatro pestañas

Para incluir un TabLayout en un ViewPager, agrega un elemento <TabLayout> dentro del elemento <ViewPager>, como se muestra a continuación:

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

Luego, usa setupWithViewPager() para vincular el TabLayout al ViewPager. Las pestañas individuales de TabLayout se completan automáticamente con los títulos de página de PagerAdapter de la siguiente manera:

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);
        }

        ...
    }
    

Para obtener ayuda adicional con el diseño de pestañas, consulta la documentación de material design para pestañas.