Recherche : spécifications
Le composant Recherche permet de saisir un mot-clé ou une expression afin d’obtenir des informations pertinentes.
Variantes
| Variante | M3 | M3 Expressive |
|---|---|---|
| Recherche | Disponible | Disponible |
Configurations
Style
La recherche se décline en deux styles :
- Contained : le style Contained possède une apparence et un comportement expressifs. Il utilise un conteneur rempli pour séparer la barre de recherche d’une liste de suggestions ou de résultats
- Divided (de base) : le style Divided (de base) ne bénéficie pas des dernières évolutions en matière de style visuel, d’animation ou de flexibilité


Mise en page
Les suggestions et les résultats de recherche s’affichent dans des listes personnalisables, selon deux modes de mise en page : plein écran et ancré. En savoir plus sur les mises en page de recherche




| Catégorie | Configuration | M3 | M3 Expressive |
|---|---|---|---|
| Style | Contained | -- | Disponible |
| Divided | Disponible | Non recommandé. Utilisez le style Contained. | |
| Mise en page | Ancrée et plein écran | Disponible | Disponible |
Jetons et spécifications
Utilisez le menu du tableau pour choisir un ensemble de jetons. L’ensemble Barre de recherche contient uniquement les jetons de la barre de recherche sans focus. L’ensemble Vue de recherche contient tous les autres jetons liés à l’interaction avec la recherche, pour tous les styles et toutes les mises en page. En savoir plus sur les jetons de design
Recherche - Vue
| Token | Valeur |
|---|---|
| Search view container surface tint layer color | #6750A4 |
Recherche - Barre
Anatomie
Le composant Recherche comprend une barre de recherche et un conteneur pour les suggestions et les résultats. Ce conteneur est vide par défaut ; utilisez le composant Liste pour y ajouter du contenu. Dans le style Divided (de base), une ligne de séparation sépare la barre de recherche de la zone de résultats.

- Conteneur de la barre de recherche
- Icône de début
- Texte d’accompagnement
- Icône de fin et avatar (facultatifs)
- Texte saisi
- Conteneur pour les suggestions ou résultats de recherche
Exemples
- Avec un avatar
- Avec un bouton d’icône de fin
- Avec deux boutons d’icône de fin
- Avec un bouton d’icône de fin et un avatar

Couleur
Les valeurs de couleur sont implémentées à l’aide de jetons de design. Pour les designers, cela signifie travailler avec des valeurs de couleur associées aux jetons. Lors de l’implémentation, une valeur de couleur correspond à un jeton, lequel référence une valeur.
Mise en page en plein écran

Rôles de couleur de la recherche en plein écran dans les thèmes clair et sombre :
- Surface container low
- On surface variant
- On surface variant
- Surface container high
- On surface variant
- On surface
Mise en page ancrée

Rôles de couleur de la recherche ancrée dans les thèmes clair et sombre :
- Surface container high
- On surface variant
- On surface variant
- Surface container high
- On surface variant
- On surface
États
Les états sont des représentations visuelles qui communiquent l’état d’un composant ou d’un élément interactif. Dans une recherche avec focus, chaque élément conserve son propre état d’interaction. En savoir plus sur les états d’interaction
Barre de recherche

- Activé
- Survolé
- Focalisé
- Appuyé (effet d’ondulation)
Suggestions et résultats de recherche
Le composant Recherche comprend un conteneur pour les suggestions et les résultats. Ce conteneur est vide par défaut ; utilisez le composant Liste pour y ajouter du contenu.

- Activé
- Survolé
- Focalisé
- Appuyé (effet d’ondulation)
Mesures
Barre de recherche


Dans M3 Expressive, la barre de recherche s’agrandit lorsqu’elle reçoit le focus. Les marges extérieures passent de 24dp à 12dp.


| Élément | Attribut | Valeur |
|---|---|---|
| Conteneur | Largeur | Min : 360dp, max : 720dp |
| Hauteur | 56dp | |
| Alignement du libellé | Aligné au début | |
| Marge intérieure de début | Sans focus : 24dp, avec focus : 12dp | |
| Marge intérieure de fin | Sans focus : 24dp, avec focus : 12dp | |
| Marge intérieure de l’icône de début et du libellé (à partir de la zone tactile) | 4dp | |
| Marge intérieure du libellé et de l’icône de fin (à partir de la zone tactile) | 4dp | |
| Avatar | Taille | 30dp |
Recherche avec focus
Style Contained


| Élément | Attribut | Valeur |
|---|---|---|
| Conteneur plein écran | Largeur | Pleine largeur |
| Hauteur | Pleine hauteur | |
| Conteneur ancré | Largeur | Min : 360dp, max : 720dp |
| Hauteur | Min : 240dp, max : 2/3 de la hauteur de l’écran | |
| Conteneur de la barre de recherche | Hauteur | 56dp |
| Alignement du libellé | Aligné au début | |
| Marge intérieure de début | 16dp | |
| Marge intérieure de fin | 16dp | |
| Marge intérieure de l’icône de début et du libellé (à partir de la zone tactile) | 4dp | |
| Marge intérieure de l’icône de début et du libellé (à partir de la zone tactile) | 4dp |
Style Divided

