Personnaliser une liste dynamique   Fait partie d'Android Jetpack.

Essayer Compose
Jetpack Compose est le kit d'outils d'UI recommandé pour Android. Découvrez comment utiliser les mises en page dans Compose.
Lazy Lists and Grids →

Vous pouvez personnaliser RecyclerView pour répondre à vos besoins spécifiques. Les classes standards décrites dans l'article Créez des listes dynamiques avec RecyclerView fournissent toutes les fonctionnalités dont la plupart des développeurs ont besoin. Dans Dans de nombreux cas, il vous suffit de concevoir la vue pour chaque conteneur de vue et d'écrire la pour mettre à jour ces vues avec les données appropriées. Toutefois, si votre application présente des exigences spécifiques, vous pouvez modifier le comportement standard de plusieurs manières. Ce document décrit certaines des personnalisations possibles.

Modifier la mise en page

RecyclerView utilise un gestionnaire de mise en page pour positionner les éléments individuels à l'écran et déterminer quand réutiliser les vues d'éléments qui ne sont plus visibles par l'utilisateur. Pour réutiliser (ou recycler) une vue, un gestionnaire de mise en page peut demander à l'adaptateur de remplacer le contenu de la vue par un élément différent de l'ensemble de données. Recycler les vues de cette manière améliore les performances en évitant de créer des vues inutiles ou d'effectuer des recherches findViewById() coûteuses. La bibliothèque d'assistance Android inclut trois gestionnaires de mise en page standards, chacun offrant de nombreuses options de personnalisation :

  • LinearLayoutManager: organise les éléments dans une liste unidimensionnelle. Avec un RecyclerView avec LinearLayoutManager fournit une fonctionnalité comme ListView mise en page.
  • GridLayoutManager : organise les éléments dans une grille à deux dimensions, comme les cases d'un damier. L'utilisation d'un RecyclerView avec GridLayoutManager offre des fonctionnalités telles qu'une mise en page GridView.
  • StaggeredGridLayoutManager: Dispose les éléments dans une grille à deux dimensions, chaque colonne étant légèrement décalée comme les étoiles sur le drapeau des États-Unis.

Si ces gestionnaires de mise en page ne répondent pas à vos besoins, vous pouvez créer les vôtres en étendant la classe abstraite RecyclerView.LayoutManager.

Ajouter des animations aux éléments

Chaque fois qu'un élément change, RecyclerView utilise un animateur. pour modifier son apparence. Cet animateur est un objet qui étend la classe abstraite RecyclerView.ItemAnimator. Par défaut, RecyclerView utilise DefaultItemAnimator pour fournir l'animation. Si vous souhaitez fournir des animations personnalisées, vous pouvez définissez votre propre objet d'animation RecyclerView.ItemAnimator

Activer la sélection des éléments de liste

La recyclerview-selection La bibliothèque permet aux utilisateurs de sélectionner des éléments d'une liste RecyclerView en appuyant sur l'écran ou la saisie à la souris. Cela vous permet de garder le contrôle sur la présentation visuelle d'une l'élément sélectionné. Vous pouvez également garder le contrôle sur les règles contrôlant la sélection. comme les articles éligibles à la sélection et le nombre doit être sélectionnée.

Pour ajouter la prise en charge de la sélection à une instance RecyclerView, procédez comme suit :

  1. Déterminez le type de clé de sélection à utiliser, puis créez un ItemKeyProvider.

    Vous pouvez utiliser trois types principaux pour identifier les éléments sélectionnés :

    Pour en savoir plus sur les types de clés de sélection, consultez SelectionTracker.Builder

  2. Implémentez ItemDetailsLookup.

    3. ItemDetailsLookup permet à la bibliothèque de sélections d'accéder informations sur RecyclerView éléments en fonction d'une MotionEvent Il s'agit en fait d'une fabrique d'instances ItemDetails sauvegardées par une instance RecyclerView.ViewHolder ou extraites de celle-ci.

  3. Mettre à jour l'élément View objets dans le RecyclerView pour indiquer si l'utilisateur sélectionne ou les désélectionne.

    La bibliothèque de sélection ne fournit pas de décoration visuelle par défaut pour le éléments sélectionnés. Fournissez-le lorsque vous implémentez onBindViewHolder(). Nous vous recommandons d'adopter l'approche suivante :

  4. Utilisez ActionMode pour fournir à l'utilisateur des outils lui permettant d'effectuer une action sur la sélection.

    5. Enregistrer un SelectionTracker.SelectionObserver pour recevoir une notification lorsqu'une sélection change. Lorsqu'une sélection est créée, démarrer ActionMode pour le présenter à l'utilisateur et fournir spécifiques à la sélection. Par exemple, vous pouvez ajouter un bouton de suppression ActionMode barre et connecter la flèche de retour sur la barre pour effacer de la sélection. Lorsque la sélection est vide (si l'utilisateur l'efface pour la dernière fois), mettez fin au mode d'action.

  5. Effectuer les actions secondaires interprétées

    6. À la fin du pipeline de traitement des événements, la bibliothèque peut déterminer que l'utilisateur tente d'activer un élément en appuyant dessus ou qu'il tente de faire glisser un élément ou un ensemble d'éléments sélectionnés. Réagir les interprétations en enregistrant l'écouteur approprié. Pour en savoir plus, consultez SelectionTracker.Builder.

  6. Assemblez le tout avec SelectionTracker.Builder.

    7. L'exemple suivant montre comment assembler ces pièces:

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

    Pour créer un SelectionTracker votre application doit fournir le même identifiant RecyclerView.Adapter que vous utilisez pour initialiser RecyclerView sur SelectionTracker.Builder C'est pourquoi, une fois la classe SelectionTracker, injectez-la dans votre RecyclerView.Adapter Sinon, vous ne pouvez pas vérifier l'état de sélection d'un élément à partir de la méthode onBindViewHolder().

  7. Incluez la sélection dans les événements de cycle de vie de l'activité.

    8. Pour préserver l'état de sélection lors des événements de cycle de vie de l'activité, votre application doit appeler les méthodes onSaveInstanceState() et onRestoreInstanceState() du traceur de sélection à partir des méthodes onSaveInstanceState() et onRestoreInstanceState() de l'activité, respectivement. Votre application doit également fournir un ID de sélection unique au paramètre Constructeur SelectionTracker.Builder. Cet ID est obligatoire, car une activité ou un fragment peuvent comporter plusieurs listes distinctes sélectionnables qui doivent tous être conservés dans leur état enregistré.

Ressources supplémentaires

Pour en savoir plus, consultez les références suivantes.