Listes : spécifications
Les listes sont des index verticaux continus de texte et d’images.
Variantes
Listes expressives
Utilisez la variante de liste expressive pour un style plus flexible, des états de sélection mis en évidence et des slots personnalisables.

Listes de référence
Les listes de référence restent disponibles, mais ne bénéficient pas des derniers styles visuels, du traitement de la sélection ni de la fonctionnalité des slots.
Sur le Web, l’implémentation des listes expressives s’appuie sur celle des listes de référence.
Voir les spécifications des listes de référence

| Variantes | M3 | M3 Expressive |
|---|---|---|
| Listes (expressives) | -- | Disponible |
| Listes (de référence) | Disponible | Non recommandées. Utilisez plutôt les listes expressives. |
Configurations
Styles
Les styles Standard et Segmenté sont des choix visuels qui n’affectent pas le comportement de la liste.

- Standard
- Segmenté
Sélection dans la liste
Une liste ne peut appliquer qu’un seul mode de sélection à la fois. Par exemple, une liste à action unique peut devenir une liste à sélection multiple, mais elle ne peut pas cumuler les deux comportements simultanément.




Interactions avec les listes
Les listes peuvent :
En savoir plus sur l’accessibilité des interactions avec les listes

| Catégorie | Configuration | M3 | M3 Expressive |
|---|---|---|---|
| Styles | Standard | Disponible | Disponible |
| Segmenté | -- | Disponible | |
| Modes de sélection | À action unique, à actions multiples, à sélection unique, à sélection multiple | Disponible | Disponible |
| Interactions | Se déplier, balayer\* | Disponible | Disponible |
* Les interactions de balayage pour révéler ne sont disponibles que sur Android Views.
Jetons et spécifications
Utilisez le menu déroulant du tableau pour sélectionner un ensemble de jetons. L’ensemble common combine les jetons de référence avec les nouvelles formes et tailles de M3 Expressive. L’ensemble expand contient les jetons de l’interaction de dépliage. En savoir plus sur les jetons de design
Liste - Common
Liste - Expand
Anatomie

Le conteneur et le texte de libellé sont obligatoires ; tous les autres éléments sont facultatifs :
- Conteneur
- Surtitre
- Texte de libellé
- Texte de fin
- Texte secondaire
- Icône de fin
- Séparateur
- Avatar de début
- Icône de début
- Média de début - image ou vidéo
Flexibilité et slots
Le M3 Design Kit inclut des listes avec des slots personnalisés pour concevoir des mises en page flexibles pour les éléments. Considérez une liste personnalisée comme un conteneur doté de trois slots : début, contenu et fin. Chaque slot peut accueillir un élément différent.
Accessibilité des slots
Les slots ne sont pas accessibles par défaut. Tenez compte des points suivants :
- Les éléments doivent respecter les règles, la structure et les modèles d’interaction propres aux listes
- Utilisez la marge interne standard des éléments de liste
- La zone cible tactile doit mesurer au moins 48 x 48 dp
- N’ajoutez pas d’éléments interactifs qui rendent l’élément de liste difficile à naviguer, en particulier pour les personnes utilisant des lecteurs d’écran
En savoir plus sur les lignes directrices d’accessibilité requises

- Slot de début
- Slot de contenu
- Slot de fin
WARNING
Les slots nécessitent une implémentation de code personnalisée que vous devez créer et maintenir.
Les positions d’emplacement de début (leading) et de fin (trailing) doivent être moins larges que la section de contenu.
1. Les slots de début peuvent contenir :
- Éléments visuels : avatar, icône, image ou miniature vidéo
- Contrôles de sélection : case à cocher, bouton radio ou commutateur
- Personnalisations : badge ou image plus grande
2. Les slots de contenu doivent être les slots les plus larges et peuvent contenir :
- Contenu par défaut : texte de libellé, texte secondaire
- Éléments complémentaires facultatifs : badge, icône, libellé en ligne ou autres éléments textuels
- Évitez les longues lignes de texte pour préserver la lisibilité
3. Les slots de fin peuvent contenir :
- Éléments d’action ou texte : icône, bouton d’icône ou texte de fin
- Contrôles de sélection : case à cocher, bouton radio ou commutateur

Listes de sélection
Pour les listes de sélection, utilisez une seule interaction de sélection par élément de liste.


Couleur
Les valeurs de couleur sont implémentées au moyen de jetons de design. Pour les designers, cela signifie utiliser des valeurs de couleur correspondant à des jetons. Dans l’implémentation, une valeur de couleur est un jeton qui référence une valeur. En savoir plus sur les jetons de design

Rôles de couleur de liste utilisés pour les thèmes clairs et sombres :
- Surface
- On surface variant
- On surface
- On surface variant
- On surface variant
- On surface variant
- Outline variant
- Primary container
- On primary container
- On surface variant
États
Les états sont des représentations visuelles qui communiquent l’état d’un composant ou d’un élément interactif. En savoir plus sur les états d’interaction
En savoir plus sur le focus des listes
Éléments de liste par défaut

- Activé
- Désactivé
- Survolé
- Avec focus
- Appuyé
- Déplacé
Éléments de liste sélectionnés

- Activé
- Désactivé
- Survolé
- Avec focus
- Appuyé
- Déplacé
Mesures

Transformation de forme
Lorsqu’un élément de liste est sélectionné, la forme des coins change pour mettre en évidence l’élément actif :
- Rayon d’angle à l’état non sélectionné : 4 dp pour les coins intérieurs, 16 dp pour les coins extérieurs
- Rayon d’angle à l’état sélectionné : 16 dp


Liste (de référence)
La variante de liste de référence est disponible et continue de fonctionner dans les produits existants. Toutefois, la variante de liste expressive est recommandée pour les nouvelles conceptions.
Jetons et spécifications
Les jetons de liste de référence se trouvent dans l’ensemble de jetons common.
TIP
Cet ensemble inclut également plusieurs jetons expressifs.
Couleur
Les valeurs de couleur sont implémentées au moyen de jetons de design. Pour les designers, cela signifie utiliser des valeurs de couleur correspondant à des jetons. Dans l’implémentation, une valeur de couleur est un jeton qui référence une valeur. En savoir plus sur les jetons de design

Rôles de couleur de liste utilisés pour les thèmes clairs et sombres :
- Surface
- On surface
- On surface variant
- On surface variant
- On surface variant
- Outline variant
- Primary container
- On primary container
- On surface variant
États
Les états sont des représentations visuelles qui communiquent l’état d’un composant ou d’un élément interactif.

- Activé
- Désactivé
- Survolé
- Avec focus
- Appuyé
- Déplacé
Mise en page
Listes sur une ligne


Listes sur deux lignes


Listes sur trois lignes


| Attribut | Valeur |
|---|---|
| Alignement du libellé | Centré |
| Alignement du libellé lorsque la hauteur est de 88 dp ou plus | En haut |
| Marge interne gauche du libellé | 16 dp |
| Alignement vertical de l’élément de début | Centré |
| Alignement vertical de l’élément de début lorsque la hauteur est de 88 dp ou plus | En haut |
| Marge interne gauche de l’élément de début | 16 dp |
| Alignement vertical de l’icône de début | En haut |
| Marge interne supérieure de l’icône de début | 8 dp |
| Marge interne supérieure de l’icône de début lorsque la hauteur est de 88 dp ou plus | 12 dp |
| Alignement vertical de l’élément de fin | Centré |
| Alignement vertical de l’élément de fin lorsque la hauteur est de 88 dp ou plus | En haut |
| Marge interne gauche de l’élément de fin | 16 dp |
| Marge interne droite de l’élément de fin | 24 dp |
| Marge interne au-dessus et en dessous du séparateur | 0 dp |
| Taille des cibles tactiles | 48 dp |
| Séparateur sur toute la largeur | 100 % |
| Retrait gauche du séparateur | 16 dp |
| Retrait droit du séparateur | 24 dp |
Configurations
Avatar de début

- Avec avatar de début
- Avec avatar de début et case à cocher de fin
Image ou miniature de début

- Avec image de début
- Avec image de début et case à cocher de fin
Vidéo de début

- Avec vidéo de début
- Avec vidéo de début et case à cocher de fin
Icône de début

- Avec icône de début
- Avec icône de début et case à cocher de fin
Texte uniquement

- Avec texte uniquement
- Avec texte et case à cocher de fin
Case à cocher de début

- Avec case à cocher de début
- Avec case à cocher de début et texte de fin
Bouton radio de début

- Avec bouton radio de début
- Avec bouton radio de début et texte de fin
Commutateur de fin

- Avec commutateur de fin
- Avec icône de début et commutateur de fin