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

Las vistas deslizantes te permiten navegar entre pantallas del mismo nivel, como pestañas, con un gesto horizontal del dedo (deslizamiento). Este patrón de navegación también se conoce como paginación horizontal. En este documento, se muestra cómo crear un diseño de pestaña con vistas deslizantes para alternar entre pestañas, además de cómo mostrar una barra de títulos en lugar de pestañas.

Nota: Para las vistas deslizantes, recomendamos la biblioteca de ViewPager2. Si deseas obtener más información, consulta Cómo crear vistas deslizantes con pestañas usando ViewPager y la guía de migración de ViewPager2.

Cómo implementar vistas deslizantes

Puedes crear vistas deslizantes con el widget ViewPager de AndroidX. Para usar ViewPager y pestañas, agrega dependencias en Viewpager y en componentes de Material en 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 tiene que consumir todo el diseño, este se verá 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, conecta 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 del mismo nivel.
• 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.

Este es un ejemplo de cómo puedes usar FragmentStatePagerAdapter para deslizarte por 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, 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 your
// 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, 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.
        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 your
// 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)));
    }
}

En la siguiente sección, se muestra cómo agregar pestañas para 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 con un ViewPager, un TabLayout proporciona una interfaz conocida 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 en el siguiente ejemplo:

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

Usa setupWithViewPager() para vincular el TabLayout al ViewPager, como se muestra en el siguiente ejemplo. Las pestañas individuales del TabLayout se completan automáticamente con los títulos de página del 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);
    }

    ...
}

Nota: Si tienes una cantidad de páginas grande o potencialmente infinita, configura el atributo android:tabMode de tu TabLayout en "scrollable". Esto evita que TabLayout incluya todas las pestañas en la pantalla a la vez y permite a los usuarios desplazarse por la lista de pestañas.

Para obtener ayuda adicional con el diseño de pestañas, consulta la documentación de Material Design sobre pestañas.