Personaliza una lista dinámica   Parte de Android Jetpack

Prueba hacerlo con Compose
Jetpack Compose es el kit de herramientas de IU recomendado para Android. Obtén información sobre cómo a trabajar con diseños en Compose.
Listas y cuadrículas con carga diferida →

Puedes personalizar los objetos RecyclerView para satisfacer tus necesidades específicas. Las clases estándar descritas en Cómo crear listas dinámicas con RecyclerView proporcionan toda la funcionalidad que la mayoría de los desarrolladores necesitan. En muchos casos, solo necesitas diseñar la vista para cada contenedor de vistas y escribir el código para actualizarlas con los datos correspondientes. Sin embargo, si tu app tiene requisitos específicos, puedes modificar el comportamiento estándar de diferentes maneras. En este documento, se describen algunas de las personalizaciones posibles.

Modifica el diseño

RecyclerView usa un administrador de diseño para posicionar los elementos individuales en la pantalla y determinar cuándo volver a usar las vistas de elementos que ya no ve el usuario. Para volver a usar (o reciclar) una vista, un administrador de diseño puede solicitar al adaptador que reemplace el contenido de la vista por un elemento diferente del conjunto de datos. Reciclar las vistas de esta manera mejora el rendimiento, ya que se evita que se creen vistas innecesarias o realicen búsquedas costosas de findViewById(). La biblioteca de compatibilidad de Android incluye tres administradores de diseño estándar, cada uno de los cuales ofrece muchas opciones de personalización:

  • LinearLayoutManager: Dispone los elementos en una lista unidimensional. Usar un RecyclerView con LinearLayoutManager ofrece funciones como un ListView diseño.
  • GridLayoutManager: Dispone los elementos en una cuadrícula bidimensional, como los cuadrados de un tablero de ajedrez. Usar un objeto RecyclerView con GridLayoutManager ofrece funciones como un diseño de GridView.
  • StaggeredGridLayoutManager: dispone los elementos en una cuadrícula bidimensional, en la que cada columna está ligeramente desplazada en función de la anterior, como las estrellas de la bandera estadounidense.

Si estos administradores de diseño no se adecuan a tus necesidades, puedes crear uno propio extendiendo la clase abstracta RecyclerView.LayoutManager.

Agrega animaciones de elementos

Siempre que cambia un elemento, RecyclerView usa un animador para modificar su apariencia. Este animador es un objeto que extiende la clase abstracta RecyclerView.ItemAnimator. De forma predeterminada, RecyclerView usa DefaultItemAnimator para proporcionar la animación. Si quieres brindar animaciones personalizadas, puedes definir tu propio objeto animador extendiendo RecyclerView.ItemAnimator.

Habilita la selección de elementos de listas

La biblioteca permite a los usuarios seleccionar elementos en una lista RecyclerView con entrada táctil o del mouse.recyclerview-selection Esto te permite mantener el control sobre la presentación visual de un elemento seleccionado. También puedes mantener el control sobre las políticas que controlan el comportamiento de selección, como qué elementos son aptos para la selección y cuántos elementos se pueden seleccionar.

Para agregar compatibilidad con la selección a una instancia de RecyclerView, sigue estos pasos:

  1. Determina el tipo de clave de selección que usarás y, luego, crea un ItemKeyProvider.

    Hay tres tipos de claves que puedes usar para identificar elementos seleccionados:

    Para obtener información detallada sobre los tipos de claves de selección, consulta SelectionTracker.Builder.

  2. Implement ItemDetailsLookup.

    3. ItemDetailsLookup permite que la biblioteca de selección acceda a información sobre elementos de RecyclerView a los que se otorga un MotionEvent. Se trata efectivamente de una fábrica de instancias de ItemDetails que están respaldadas por una instancia de RecyclerView.ViewHolder, o que se extraen de ella.

  3. Actualiza los objetos View del elemento en RecyclerView para reflejar si el usuario los selecciona o anula su selección.

    La biblioteca de selección no proporciona una decoración visual predeterminada para los elementos seleccionados. Proporciónala cuando implementes onBindViewHolder(). Te recomendamos el siguiente enfoque:

  4. Usa ActionMode para proporcionar al usuario herramientas para realizar una acción en la selección.

    5. Registra un objeto SelectionTracker.SelectionObserver para recibir una notificación cuando cambie una selección. Cuando se crea una selección por primera vez, inicia ActionMode para presentársela al usuario y proporciona acciones específicas de la selección. Por ejemplo, puedes agregar un botón de eliminación a la barra de ActionMode y conectar la flecha hacia atrás de la barra para borrar la selección. Cuando se vacía la selección (si el usuario borró la selección la última vez), finaliza el modo de acción.

  5. Realiza las acciones secundarias interpretadas.

    6. Al final de la canalización del procesamiento de eventos, la biblioteca puede determinar que el usuario intenta activar un elemento cuando lo presiona o que intenta arrastrar un elemento o conjunto de elementos seleccionados. Registra el objeto de escucha correspondiente como reacción a estas interpretaciones. Para obtener más información, consulta SelectionTracker.Builder.

  6. Ensambla todo con SelectionTracker.Builder.

    7. En el siguiente ejemplo, se muestra cómo unir estas partes:

    Kotlin

        var tracker = SelectionTracker.Builder(
        "my-selection-id",
        recyclerView,
        StableIdKeyProvider(recyclerView),
        MyDetailsLookup(recyclerView),
        StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build()

    Java

        SelectionTracker tracker = new SelectionTracker.Builder<>(
            "my-selection-id",
            recyclerView,
            new StableIdKeyProvider(recyclerView),
            new MyDetailsLookup(recyclerView),
            StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build();

    Para crear una instancia de SelectionTracker, tu app debe proporcionar el mismo objeto RecyclerView.Adapter que usas para inicializar RecyclerView en SelectionTracker.Builder. Por este motivo, después de crear la instancia de SelectionTracker, insértala en tu RecyclerView.Adapter. De lo contrario, no podrás verificar el estado seleccionado de un elemento con el método onBindViewHolder().

  7. Incluye la selección en los eventos del ciclo de vida de la actividad.

    8. Para preservar el estado de selección entre los eventos del ciclo de vida de la actividad, tu app debe llamar a los métodos onSaveInstanceState() y onRestoreInstanceState() del seguimiento de selección de los métodos onSaveInstanceState() y onRestoreInstanceState() de la actividad, respectivamente. Tu app también debe proporcionar un ID de selección único al constructor SelectionTracker.Builder. Este ID es obligatorio porque una actividad o un fragmento pueden tener más de una lista distinta para seleccionar, y todas deben persistir en su estado guardado.

Recursos adicionales

Consulta las siguientes referencias para obtener información adicional.