Directives de conception de la plateforme Android — Material Design 3
1. Material You et Thématisation [CRITIQUE]
1.1 Couleur dynamique
Activez la couleur dynamique dérivée du fond d'écran de l'utilisateur. La couleur dynamique est la stratégie de thématisation par défaut sur Android 12+.
// Compose : Thème couleur dynamique
@Composable
fun AppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
dynamicColor: Boolean = true,
content: @Composable () -> Unit
) {
val colorScheme = when {
dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
val context = LocalContext.current
if (darkTheme) dynamicDarkColorScheme(context)
else dynamicLightColorScheme(context)
}
darkTheme -> darkColorScheme()
else -> lightColorScheme()
}
MaterialTheme(
colorScheme = colorScheme,
typography = AppTypography,
content = content
)
}
<!-- XML : Couleur dynamique dans themes.xml -->
<style name="Theme.App" parent="Theme.Material3.DayNight.NoActionBar">
<item name="dynamicColorThemeOverlay">@style/ThemeOverlay.Material3.DynamicColors.DayNight</item>
</style>
Règles :
- R1.1 : Fournissez toujours un jeu de couleurs statique de secours pour les appareils antérieurs à Android 12.
- R1.2 : Ne codez jamais en dur les valeurs hexadécimales des couleurs dans les composants. Référencez toujours les rôles de couleurs du thème.
- R1.3 : Testez avec au moins 3 fonds d'écran différents pour vérifier l'harmonie des couleurs dynamiques.
1.2 Rôles des couleurs
Material 3 définit un ensemble structuré de rôles de couleurs. Utilisez-les de manière sémantique, pas esthétique.
| Rôle | Utilisation | Sur le rôle |
|---|---|---|
primary | Actions clés, états actifs, FAB | onPrimary |
primaryContainer | Éléments primaires moins importants | onPrimaryContainer |
secondary | Interface de support, chips de filtre | onSecondary |
secondaryContainer | Indicateur actif de la barre de navigation | onSecondaryContainer |
tertiary | Accent, contraste, complémentaire | onTertiary |
tertiaryContainer | Champs de saisie, accents moins importants | onTertiaryContainer |
surface | Arrière-plans, cartes, feuilles | onSurface |
surfaceVariant | Éléments décoratifs, séparateurs | onSurfaceVariant |
error | États d'erreur, actions destructrices | onError |
errorContainer | Arrière-plans d'erreur | onErrorContainer |
outline | Bordures, séparateurs | — |
outlineVariant | Bordures subtiles | — |
inverseSurface | Arrière-plan du Snackbar | inverseOnSurface |
// Correct : rôles de couleurs sémantiques
Text(
text = "Message d'erreur",
color = MaterialTheme.colorScheme.error
)
Surface(color = MaterialTheme.colorScheme.errorContainer) {
Text(text = "Détail de l'erreur", color = MaterialTheme.colorScheme.onErrorContainer)
}
// ERRONÉ : couleurs codées en dur
Text(text = "Erreur", color = Color(0xFFB00020)) // Anti-patron
Règles :
- R1.4 : Chaque élément de premier plan doit utiliser le rôle de couleur « on » correspondant à son arrière-plan (par exemple, texte
onPrimarysur fondprimary). - R1.5 : Utilisez
surfaceet ses variantes pour les arrière-plans. N'utilisez jamaisprimaryousecondarycomme grandes zones d'arrière-plan. - R1.6 : Utilisez
tertiaryavec parcimonie, uniquement pour l'accentuation et le contraste complémentaire.
1.3 Thèmes clair et sombre
Prenez en charge les thèmes clair et sombre. Respectez le réglage système par défaut.
// Compose : Détection du thème système
val darkTheme = isSystemInDarkTheme()
Règles :
- R1.7 : Prenez toujours en charge les thèmes clair et sombre. Ne publiez jamais une application en mode clair uniquement.
- R1.8 : Les surfaces du thème sombre utilisent un mappage tonal basé sur l'élévation, pas du noir pur (#000000). Utilisez les rôles de couleur
surfacequi gèrent cela automatiquement. - R1.9 : Fournissez une option de remplacement manuel du thème dans les paramètres de l'application (Système / Clair / Sombre).
1.4 Couleurs personnalisées à partir d'une graine
Lorsque l'image de marque nécessite des couleurs personnalisées, fournissez une couleur de graine et générez des palettes tonales à l'aide de Material Theme Builder.
// Jeu de couleurs personnalisé avec une graine de marque
private val BrandLightColorScheme = lightColorScheme(
primary = Color(0xFF1B6D2F),
onPrimary = Color(0xFFFFFFFF),
primaryContainer = Color(0xFFA4F6A8),
onPrimaryContainer = Color(0xFF002107),
// ... générer la palette complète à partir de la graine
)
Règles :
- R1.10 : Générez les palettes tonales à partir de couleurs de graine à l'aide de Material Theme Builder. Ne sélectionnez jamais manuellement des teintes individuelles.
- R1.11 : Lorsque vous utilisez des couleurs personnalisées, prenez toujours en charge la couleur dynamique par défaut et utilisez les couleurs personnalisées comme solution de secours.
2. Navigation [CRITIQUE]
2.1 Barre de navigation (en bas)
Le modèle de navigation principal pour les téléphones avec 3 à 5 destinations de premier niveau.
// Compose : Barre de navigation
NavigationBar {
items.forEachIndexed { index, item ->
NavigationBarItem(
icon = {
Icon(
imageVector = if (selectedItem == index) item.filledIcon else item.outlinedIcon,
contentDescription = item.label
)
},
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
Règles :
- R2.1 : Utilisez la barre de navigation pour 3 à 5 destinations de premier niveau sur les écrans compacts. Ne l'utilisez jamais pour moins de 3 ou plus de 5 destinations.
- R2.2 : Affichez toujours les libellés sur les éléments de la barre de navigation. Les barres de navigation avec uniquement des icônes ne sont pas autorisées.
- R2.3 : Utilisez des icônes pleines pour l'état sélectionné et des icônes avec contour pour les états non sélectionnés.
- R2.4 : L'indicateur actif utilise la couleur
secondaryContainer. Ne modifiez pas cela.
2.2 Rail de navigation
Pour les écrans moyens et larges (tablettes, pliables, bureau).
// Compose : Rail de navigation pour les grands écrans
NavigationRail(
header = {
FloatingActionButton(
onClick = { /* action principale */ },
containerColor = MaterialTheme.colorScheme.tertiaryContainer
) {
Icon(Icons.Default.Add, contentDescription = "Créer")
}
}
) {
items.forEachIndexed { index, item ->
NavigationRailItem(
icon = { Icon(item.icon, contentDescription = item.label) },
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
Règles :
- R2.5 : Utilisez le rail de navigation sur les fenêtres de taille moyenne (600-839dp) et large (840dp+). Associez-le à la barre de navigation sur les fenêtres compactes.
- R2.6 : Incluez éventuellement un FAB dans l'en-tête du rail pour l'action principale.
- R2.7 : Les libellés sont facultatifs sur le rail mais recommandés pour plus de clarté.
2.3 Tiroir de navigation
Pour 5 destinations ou plus, ou des hiérarchies de navigation complexes, généralement sur les écrans larges.
// Compose : Tiroir de navigation permanent pour les grands écrans
PermanentNavigationDrawer(
drawerContent = {
PermanentDrawerSheet {
Text("Nom de l'application", modifier = Modifier.padding(16.dp),
style = MaterialTheme.typography.titleMedium)
HorizontalDivider()
items.forEach { item ->
NavigationDrawerItem(
label = { Text(item.label) },
selected = item == selectedItem,
onClick = { selectedItem = item },
icon = { Icon(item.icon, contentDescription = null) }
)
}
}
}
) {
Scaffold { /* contenu de la page */ }
}
Règles :
- R2.8 : Utilisez le tiroir modal sur les écrans compacts et le tiroir permanent sur les écrans larges.
- R2.9 : Regroupez les éléments du tiroir en sections avec des séparateurs et des en-têtes de section.
2.4 Geste de retour prédictif
Android 13+ prend en charge le retour prédictif avec un aperçu animé.
// Compose : Retour prédictif avec BackHandler (androidx.activity.compose)
BackHandler(enabled = true) {
// Appelé lorsque le retour est confirmé ; naviguez vers l'arrière dans votre contrôleur de navigation
navController.popBackStack()
}
// Compose : Animation de progression du retour prédictif à l'aide du modificateur predictiveBackHandler
// (androidx.activity:activity-compose 1.8+)
Modifier.predictiveBackHandler(enabled = true) { progress ->
// progress est un Flow<BackEventCompat> avec x, y, swipeEdge, progress (0.0–1.0)
progress.collect { backEvent ->
animationState = backEvent.progress
}
}
<!-- AndroidManifest.xml : opt-in pour le retour prédictif -->
<application android:enableOnBackInvokedCallback="true">
Règles :
- R2.10 : Optez pour le retour prédictif dans le manifeste. Dans les applications Compose, utilisez
BackHandler(deandroidx.activity.compose) pour intercepter les événements de retour. Dans les applications View, implémentezOnBackInvokedCallback(API 33+) ouOnBackPressedCallback(AndroidX) au lieu de surchargeronBackPressed(). - R2.11 : Le geste de retour système navigue vers l'arrière dans la pile de navigation. Le bouton Haut (flèche de la barre d'outils) navigue vers le haut dans la hiérarchie de l'application. Ceux-ci peuvent différer.
- R2.12 : N'interceptez jamais le retour système pour afficher des boîtes de dialogue « êtes-vous sûr ? » sauf en cas de saisie utilisateur non enregistrée.
- R2.13 : Ne supprimez pas l'animation d'aperçu de retour fournie par le système. Si vous implémentez des transitions d'entrée/sortie personnalisées, interpolez-les à l'aide de
BackEventCompat.progress(0.0–1.0) et respectezBackEventCompat.swipeEdge(EDGE_LEFT/EDGE_RIGHT) afin que l'écran de sortie se réduise et se déplace vers le bord initiateur, correspondant à l'animation système. - R2.14 : Préférez la reconnaissance au rappel. Gardez les destinations étiquetées, l'état sélectionné visible et le contexte de la pile de retour préservé afin que les utilisateurs n'aient pas à reconstruire où ils se trouvent après chaque étape de navigation.
// Compose : piloter une animation personnalisée à partir de la progression du retour prédictif
Modifier.predictiveBackHandler(enabled = true) { progress ->
progress.collect { backEvent ->
// backEvent.progress : 0.0 (début du geste) → 1.0 (confirmé)
// backEvent.swipeEdge : BackEventCompat.EDGE_LEFT ou EDGE_RIGHT
exitScale = 1f - (backEvent.progress * 0.1f)
exitOffsetX = if (backEvent.swipeEdge == BackEventCompat.EDGE_LEFT) -backEvent.progress * 32.dp.toPx() else backEvent.progress * 32.dp.toPx()
}
}
2.5 Sélection du composant de navigation
| Taille d'écran | 3-5 Destinations | 5+ Destinations |
|---|---|---|
| Compact (< 600dp) | Barre de navigation | Tiroir modal + Barre de navigation |
| Moyen (600-839dp) | Rail de navigation | Tiroir modal + Rail de navigation |
| Large (840dp+) | Rail de navigation | Tiroir permanent |
3. Mise en page et adaptation [ÉLEVÉ]
3.1 Classes de taille de fenêtre
Utilisez les classes de taille de fenêtre pour les mises en page adaptatives, pas les points d'arrêt en pixels bruts.
// Compose : Classes de taille de fenêtre
val windowSizeClass = calculateWindowSizeClass(this)
when (windowSizeClass.widthSizeClass) {
WindowWidthSizeClass.Compact -> CompactLayout()
WindowWidthSizeClass.Medium -> MediumLayout()
WindowWidthSizeClass.Expanded -> ExpandedLayout()
}
| Classe | Largeur | Appareil typique | Colonnes |
|---|---|---|---|
| Compact | < 600dp | Téléphone portrait | 4 |
| Moyen | 600-839dp | Tablette portrait, pliable | 8 |
| Large | 840dp+ | Tablette paysage, bureau | 12 |
Règles :
- R3.1 : Utilisez toujours
WindowSizeClassdematerial3-window-size-classpour les décisions de mise en page adaptative. - R3.2 : N'utilisez jamais de points d'arrêt en pixels fixes. Les catégories d'appareils sont fluides.
- R3.3 : Prenez en charge les trois classes de taille de largeur. Au minimum, compact et large.
3.2 Grille Material
Appliquez les marges et gouttières canoniques de la grille Material.
| Classe de taille | Marges | Gouttières | Colonnes |
|---|---|---|---|
| Compact | 16dp | 8dp | 4 |
| Moyen | 24dp | 16dp | 8 |
| Large | 24dp | 24dp | 12 |
Règles :
- R3.4 : Le contenu ne doit pas s'étendre sur toute la largeur sur les écrans larges. Utilisez une largeur de contenu maximale d'environ 840 dp ou une disposition liste-détail.
- R3.5 : Appliquez des marges horizontales cohérentes correspondant aux spécifications de la grille.
3.3 Affichage edge-to-edge
Android 15+ impose l'affichage edge-to-edge. Toutes les applications doivent dessiner derrière les barres système.
// Compose : Configuration edge-to-edge
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
Scaffold(
modifier = Modifier.fillMaxSize(),
// Scaffold gère les encoches pour les barres supérieure/inférieure automatiquement
) { innerPadding ->
Content(modifier = Modifier.padding(innerPadding))
}
}
}
}
Règles :
- R3.6 : Appelez
enableEdgeToEdge()avantsetContent. Dessinez derrière la barre d'état et la barre de navigation. - R3.7 : Utilisez
WindowInsetspour éloigner le contenu des barres système.Scaffoldgère cela pour le contenu de la barre supérieure et de la barre inférieure automatiquement. - R3.8 : Le contenu défilant doit défiler derrière les barres système transparentes avec un remplissage d'encoche approprié en haut et en bas de la liste.
3.4 Prise en charge des appareils pliables
// Compose : Détection de la posture de pliage
val foldingFeatures = WindowInfoTracker.getOrCreate(context)
.windowLayoutInfo(context)
.collectAsState(initial = WindowLayoutInfo(emptyList()))
Règles :
- R3.9 : Détectez la position de la charnière/du pli et évitez de placer du contenu critique à travers le pli.
- R3.10 : Utilisez
ListDetailPaneScaffoldouSupportingPaneScaffoldde la bibliothèque adaptative Material3 pour les mises en page adaptées aux pliables.
4. Typographie [ÉLEVÉ]
4.1 Échelle typographique Material
| Rôle | Taille par défaut | Poids par défaut | Utilisation |
|---|---|---|---|
| displayLarge | 57sp | 400 | Texte héros, onboarding |
| displayMedium | 45sp | 400 | Texte de fonctionnalité important |
| displaySmall | 36sp | 400 | Affichage important |
| headlineLarge | 32sp | 400 | Titres d'écran |
| headlineMedium | 28sp | 400 | En-têtes de section |
| headlineSmall | 24sp | 400 | Titres de cartes |
| titleLarge | 22sp | 400 | Titre de la barre d'application supérieure |
| titleMedium | 16sp | 500 | Onglets, navigation |
| titleSmall | 14sp | 500 | Sous-titres |
| bodyLarge | 16sp | 400 | Texte du corps principal |
| bodyMedium | 14sp | 400 | Texte du corps secondaire |
| bodySmall | 12sp | 400 | Légendes |
| labelLarge | 14sp | 500 | Boutons, libellés importants |
| labelMedium | 12sp | 500 | Chips |
| labelSmall | 11sp | 500 | Badges, petits libellés |
Règles :
- R4.1 : Utilisez toujours les styles de texte Material 3 (
MaterialTheme.typography.role). N'appliquez jamais directement les taillessp/dp. - R4.2 : Personnalisez les polices via un fichier de police dans
res/fontet le système de typographie Compose ou la famille de polices XML. - R4.3 : Maintenez un contraste de 3:1 entre le texte et les surfaces colorées non textuelles, mais de 4.5:1 pour le texte et les icônes (conformité WCAG AA).
- R4.4 : Utilisez
lineHeight=fontSize * 1.2pour les titres etfontSize * 1.5pour le corps du texte. - R4.5 : N'utilisez jamais
displayLargeoudisplayMediumpour du contenu dynamique. Réservez-les pour les écrans de marque et les écrans d'accueil.
// Compose : Application correcte de la typographie
Text(
text = "Titre de l'écran",
style = MaterialTheme.typography.headlineMedium
)
5. Composants [MOYEN]
5.1 Boutons
| Type | Usage | Où |
|---|---|---|
FilledButton | Action principale | Boîtes de dialogue, formulaires |
FilledTonalButton | Action secondaire | Zones de contenu |
OutlinedButton | Alternative modérée | Dialogues, listes |
[contenu tronqué pour la traduction]