Material Design 3
Cette compétence guide l'implémentation de Material Design 3 (MD3) de Google — un système de design personnel, adaptatif et expressif. MD3 utilise la couleur dynamique, les surfaces tonales, les formes arrondies et le mouvement basé sur des ressorts pour créer des interfaces qui semblent vivantes et personnelles.
Philosophie
MD3 repose sur trois principes :
- Personnel : La couleur dynamique adapte l'interface au fond d'écran ou au contenu de l'utilisateur. Le thème est individuel, pas universel.
- Adaptatif : Les mises en page se transforment à travers 5 classes de taille de fenêtre. Les composants se redimensionnent, se repositionnent et changent de facteur de forme de manière réactive.
- Expressif : La morphing des formes, la physique des ressorts et la typographie accentuée créent des moments de plaisir sans sacrifier la convivialité.
Mises à jour actuelles : Google I/O 2026
La mise à jour Google I/O 2026 de Material renforce une voie Compose-first pour Android et élargit les directives expressives/adaptatives :
- Material Android est Compose-first : Pour tout nouveau travail Android, privilégiez Jetpack Compose Material3 pour les derniers composants, les API expressives, les échafaudages adaptatifs et l'intégration de l'API Styles. Les Android Views peuvent rester nécessaires dans les applications existantes, mais ne doivent pas être considérées comme le chemin par défaut pour les nouvelles implémentations Material 3.
- Système de mise en page expressive : Utilisez un échafaudage de mise en page expressive pour adapter les écrans sur mobile, desktop, pliables, montres, XR et autres facteurs de forme spatiaux. Commencez par des échafaudages adaptatifs/classes de taille de fenêtre plutôt que des mises en page fixes centrées sur le téléphone.
- Système d'espacement 8dp : Appliquez des tokens d'espacement pour les marges, le padding et les espaces afin que les mises en page et les composants puissent s'adapter par programme au type d'appareil et à la densité.
- Composants expressifs nouveaux/mis à jour : Les listes, menus, recherche et barres d'application de recherche ont des directives expressives actualisées, avec Jetpack Compose comme cible d'implémentation principale.
- Montres et XR : Les montres mettent l'accent sur les mouvements basés sur la physique, le texte en arc et les conteneurs épousant les bords. La XR met l'accent sur les panneaux spatiaux et l'élévation basée sur la profondeur.
Différences clés avec MD2 :
- Les surfaces tonales remplacent les ombres d'élévation comme principal indicateur de profondeur
- La couleur dynamique génère des schémas complets à partir d'une seule couleur source
- Coins entièrement arrondis par défaut (pas légèrement arrondis)
- La physique de mouvement basée sur des ressorts remplace les courbes d'assouplissement fixes pour les composants
- 3 niveaux de contraste contrôlés par l'utilisateur (standard/moyen/élevé)
Relation avec la compétence frontend-design : Lorsque les deux compétences sont actives, MD3 fournit le système de design (tokens, composants, règles de mise en page) et frontend-design fournit la direction créative dans ces contraintes. Les règles MD3 prévalent pour la structure des composants et l'utilisation des tokens. Remarque : Roboto/Roboto Flex EST la police par défaut correcte dans MD3 — la directive frontend-design d'éviter Roboto ne s'applique pas lors de l'implémentation de MD3.
Arbre de décision
Que construisez-vous ?
Échafaudage complet d'application → Voir "Modèles courants : Shell d'application" + references/layout-and-responsive.md
Composant unique → Voir "Référence rapide des composants" tableau → references/component-catalog.md
Thème personnalisé → Voir references/theming-and-dynamic-color.md
Formulaire / mise en page de saisie → Voir references/component-catalog.md § Input Components
Structure de navigation → Voir references/navigation-patterns.md
Affichage de données → Voir references/component-catalog.md § Data Display
Quelle plateforme ?
Jetpack Compose → Principal : androidx.compose.material3, MaterialTheme, references/*
Flutter → useMaterial3: true dans ThemeData, ColorScheme.fromSeed()
Web (vanilla JS) → @material/web (limité ; mode maintenance) + propriétés personnalisées CSS
Web (React/Vue/Svelte) → Propriétés personnalisées CSS + composants wrapper (pas de bibliothèque React officielle)
Web (CSS uniquement) → Valeurs des tokens MD3 comme propriétés personnalisées CSS (pas d'éléments <md-*>)
Système de tokens de design
Tous les tokens MD3 utilisent l'espace de noms md.sys. Jetpack Compose mappe les rôles vers MaterialTheme.colorScheme, MaterialTheme.typography et MaterialTheme.shapes (mêmes rôles sémantiques que la spécification). Sur le Web, ils sont mappés vers des propriétés personnalisées CSS (--md-sys-*) :
Tokens de couleur (--md-sys-color-*)
| Token | Objectif |
|---|---|
primary | Remplissages à haute emphase, texte, icônes sur la surface |
on-primary | Texte/icônes sur primary |
primary-container | Remplissage distinctif pour les composants clés (FAB, etc.) |
on-primary-container | Texte/icônes sur primary-container |
secondary / on-secondary | Accents moins importants |
secondary-container / on-secondary-container | Composants récessifs (boutons tonals) |
tertiary / on-tertiary | Accents contrastants |
tertiary-container / on-tertiary-container | Conteneurs complémentaires |
error / on-error | États d'erreur (statiques — ne changent pas avec la couleur dynamique) |
error-container / on-error-container | Remplissages des conteneurs d'erreur |
surface | Arrière-plan par défaut |
on-surface | Texte/icônes sur toute surface |
on-surface-variant | Texte/icônes à emphase réduite sur la surface |
surface-container-lowest | Conteneur à emphase la plus basse |
surface-container-low | Conteneur à faible emphase |
surface-container | Conteneur par défaut (zones de navigation) |
surface-container-high | Conteneur à haute emphase |
surface-container-highest | Conteneur à emphase la plus haute |
surface-dim / surface-bright | Maintiennent la luminosité relative entre clair et sombre |
inverse-surface / inverse-on-surface / inverse-primary | Éléments contrastants (snackbars) |
outline | Limites importantes (bordures de champ de texte) |
outline-variant | Éléments décoratifs (séparateurs) |
Détails complets : references/color-system.md
Tokens de typographie (--md-sys-typescale-*)
| Échelle | Tailles | Utilisation |
|---|---|---|
| Display | L / M / S | Texte héro, grands nombres |
| Headline | L / M / S | En-têtes de section |
| Title | L / M / S | En-têtes plus petits, titres de cartes |
| Body | L / M / S | Texte de paragraphe, descriptions |
| Label | L / M / S | Boutons, chips, légendes |
Chaque style a des tokens pour : -font, -weight, -size, -line-height, -tracking
Plus 15 variantes accentuées (poids plus élevé) via --md-sys-typescale-emphasized-*
Détails complets : references/typography-and-shape.md
Tokens de forme (--md-sys-shape-corner-*)
| Token | Valeur | Exemples de composants |
|---|---|---|
none | 0dp | — |
extra-small | 4dp | Chips, snackbars |
small | 8dp | Champs de texte, menus |
medium | 12dp | Cartes |
large | 16dp | FABs, tiroir de navigation |
large-increased | 20dp | (Expressif) |
extra-large | 28dp | Boîtes de dialogue, feuilles inférieures |
extra-large-increased | 32dp | (Expressif) |
extra-extra-large | 48dp | (Expressif) |
full | 9999px | Boutons, chips, badges |
Niveaux d'élévation
| Niveau | DP | Décalage tonal | Utilisation |
|---|---|---|---|
| 0 | 0dp | Aucun | Surfaces planes, la plupart des composants au repos |
| 1 | 1dp | +5% primary | Cartes surélevées, feuilles modales |
| 2 | 3dp | +8% primary | Menus, barre de navigation, barre d'application défilée |
| 3 | 6dp | +11% primary | FAB, boîtes de dialogue, recherche, sélecteurs de date/heure |
| 4 | 8dp | +12% primary | (augmentation au survol/focus uniquement) |
| 5 | 12dp | +14% primary | (augmentation au survol/focus uniquement) |
L'élévation dans MD3 est communiquée par la couleur de surface tonale, pas par les ombres. Les ombres ne sont utilisées que lorsque nécessaire pour une protection supplémentaire contre les arrière-plans chargés.
Mouvement
MD3 Expressif (mai 2025) a introduit la physique de mouvement basée sur des ressorts pour les composants. Le système hérité d'assouplissement/durée est encore utilisé pour les transitions (entrée/sortie/axe partagé) :
| Assouplissement | Durée | Type de transition |
|---|---|---|
| Accentué | 500ms | Début et fin à l'écran |
| Accentué décéléré | 400ms | Entrée à l'écran |
| Accentué accéléré | 200ms | Sortie de l'écran |
| Standard | 300ms | Début et fin à l'écran (utilitaire) |
| Standard décéléré | 250ms | Entrée à l'écran (utilitaire) |
| Standard accéléré | 200ms | Sortie de l'écran (utilitaire) |
Valeurs d'assouplissement CSS :
- Accentué :
cubic-bezier(0.2, 0, 0, 1) - Accentué décéléré :
cubic-bezier(0.05, 0.7, 0.1, 1) - Accentué accéléré :
cubic-bezier(0.3, 0, 0.8, 0.15) - Standard :
cubic-bezier(0.2, 0, 0, 1) - Standard décéléré :
cubic-bezier(0, 0, 0, 1) - Standard accéléré :
cubic-bezier(0.3, 0, 1, 1)
Référence rapide des composants
| Composant | Élément Web | Variantes clés | Catégorie |
|---|---|---|---|
| Bouton | md-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-button | Rempli, Contour, Texte, Surélevé, Tonal ; 5 tailles (XS–XL) ; bascule | Actions |
| Groupe de boutons | md-button-group | Standard, connecté | Actions |
| FAB étendu | md-extended-fab | Surface, Primaire, Secondaire, Tertiaire | Actions |
| FAB | md-fab | Petit, Moyen, Grand | Actions |
| Menu FAB | — | — | Actions |
| Bouton icône | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | Standard, Rempli, Tonal Rempli, Contour | Actions |
| Bouton segmenté | — | Sélection unique, Sélection multiple | Actions |
| Bouton partagé | — | — | Actions |
| Badge | — | Petit (point), Grand (nombre) | Communication |
| Indicateur de chargement | — | Linéaire, Circulaire | Communication |
| Indicateur de progression | md-linear-progress, md-circular-progress | Linéaire, Circulaire ; déterminé/indéterminé | Communication |
| Snackbar | — | Ligne unique, Deux lignes, Action | Communication |
| Infobulle | — | Simple, Riche | Communication |
| Carte | — | Remplie, Contour, Surélevée | Contenant |
| Carrousel | — | Multi-parcours, Non contenu, Héro | Contenant |
| Boîte de dialogue | md-dialog | Basique, Plein écran | Contenant |
| Feuille inférieure | — | Standard, Modale | Feuilles |
| Feuille latérale | — | Standard, Modale | Feuilles |
| Séparateur | md-divider | Pleine largeur, Encart | Contenant |
| Case à cocher | md-checkbox | — | Saisie |
| Chips | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | Assistance, Filtre, Saisie, Suggestion | Saisie |
| Sélecteur de date | — | Ancré, Modale, Plage | Saisie |
| Menu | md-menu, md-menu-item | — | Saisie |
| Bouton radio | md-radio | — | Saisie |
| Curseur | md-slider | Continu, Discret, Plage | Saisie |
| Interrupteur | md-switch | Avec/sans icône | Saisie |
| Champ de texte | md-filled-text-field, md-outlined-text-field | Rempli, Contour | Saisie |
| Sélecteur d'heure | — | Ancré, Modale | Saisie |
| Barre d'application (haut) | — | Centrée, Petite, Moyenne, Grande | Navigation |
| Barre de navigation | md-navigation-bar | — | Navigation |
| Tiroir de navigation | md-navigation-drawer | Standard, Modale | Navigation |
| Rail de navigation | — | — | Navigation |
| Recherche | — | Barre de recherche, Vue de recherche | Navigation |
| Onglets | md-tabs, md-primary-tab, md-secondary-tab | Primaire, Secondaire | Navigation |
| Barre d'outils | — | — | Navigation |
| Liste | md-list, md-list-item | Une ligne, Deux lignes, Trois lignes | Affichage de données |
Remarque : Les composants marqués avec — pour l'élément Web n'ont pas encore d'implémentations @material/web. Utilisez des propriétés personnalisées CSS avec du HTML standard pour ces composants. Les mappages et exemples Compose se trouvent dans references/component-catalog.md.
Détails complets des composants avec exemples de code : references/component-catalog.md
Jetpack Compose (principal)
Utilisez androidx.compose.material3 avec MaterialTheme et les composables Material 3 (Scaffold, Button, NavigationBar, barres d'application supérieures, etc.).
- Thématisation :
MaterialTheme(colorScheme = …, typography = …, shapes = …). PréférezdynamicLightColorScheme/dynamicDarkColorSchemesur Android 12+ (API 31+) lorsque la couleur dynamique est souhaitée ; sinonlightColorScheme/darkColorSchemeou le code de thème généré à partir de Material Theme Builder. - UI adaptative : Classes de taille de fenêtre, mises en page liste-détail et volet de support, pliables — voir
references/layout-and-responsive.mdetreferences/navigation-patterns.md. - Bord à bord et encarts : Disposez le contenu avec
WindowInsets/ le padding de l'échafaudage pour que les barres et l'IME se comportent correctement — voirreferences/layout-and-responsive.md. - API expérimentales : Certaines API Material 3 nécessitent
@OptIn(ExperimentalMaterial3Api::class)ou des opt-ins expressifs ; faites correspondre votre BOM et votre compilateur.
MaterialTheme(
colorScheme = colorScheme, // de dynamicLightColorScheme / lightColorScheme / etc.
typography = Typography(),
shapes = Shapes(),
) {
// Contenu M3 — préférez les références pour Scaffold, navigation, champs de texte
}
Web (limité) : @material/web
Important : Selon Material Design 3 pour le Web, les composants Web Material sont en mode maintenance et M3 Expressif n'est pas implémenté sur le Web. Utilisez @material/web pour les interfaces Web basées sur des tokens lorsque cela est approprié, mais ne le traitez pas comme équivalent à Compose pour les fonctionnalités expressives actuelles.
Configuration
npm install @material/web
Importer les composants individuellement
Importez toujours uniquement les composants que vous utilisez — importer l'ensemble du package gonfle le bundle :
// Bien — importations individuelles
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';
// Mal — ne faites jamais cela
import '@material/web'; // importe tout
Utilisation de base
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
<md-filled-button>Commencer</md-filled-button>
<md-outlined-text-field label="Email" type="email"></md-outlined-text-field>
<script type="module">
import '@material/web/button/filled-button.js';
import '@material/web/textfield/outlined-text-field.js';
</script>
</body>
</html>