Passer de Material 2.5 à Material 3 dans Compose pour Wear OS

Material 3 Expressive est la nouvelle évolution de Material Design. Elle inclut des thèmes et des composants mis à jour ainsi que des fonctionnalités de personnalisation telles que les couleurs dynamiques.

Ce guide traite de la migration de la bibliothèque Jetpack Wear Compose Material 2.5 (androidx.wear.compose) vers la bibliothèque Jetpack Wear Compose Material 3 (androidx.wear.compose.material3) pour les applications.

Approches

Pour migrer le code de votre application de M2.5 vers M3, suivez la même approche que celle décrite dans les conseils de migration pour Compose Material sur téléphone, en particulier :

Dépendances

M3 possède un package et une version distincts de M2.5 :

M2.5

implementation("androidx.wear.compose:compose-material:1.4.0")

M3

implementation("androidx.wear.compose:compose-material3:1.7.1")

Consultez les dernières versions de M3 sur la page des versions de Wear Compose.

La version 1.7.1 de la bibliothèque Wear Compose Foundation a introduit de nouveaux composants conçus pour fonctionner avec les composants Material 3. De même, SwipeDismissableNavHost de la bibliothèque Wear Compose Navigation dispose d'une animation mise à jour lorsqu'il s'exécute sur Wear OS 6 (niveau d'API 36) ou version ultérieure. Lorsque vous passez à la version Wear Compose Material 3, nous vous suggérons de mettre également à jour les bibliothèques Wear Compose Foundation et Navigation :

implementation("androidx.wear.compose:compose-foundation:1.7.1")
implementation("androidx.wear.compose:compose-navigation:1.7.1")

Thème

Dans M2.5 et M3, le composable Thème est appelé MaterialTheme, mais les packages et paramètres d'importation diffèrent. Dans M3, le paramètre Colors a été renommé ColorScheme, et MotionScheme a été introduit pour implémenter des transitions.

M2.5

import androidx.wear.compose.material.MaterialTheme

MaterialTheme(
    colors = AppColors,
    typography = AppTypography,
    shapes = AppShapes,
    content = content
)

M3

import androidx.wear.compose.material3.MaterialTheme
// ...
    MaterialTheme(
        colorScheme = ColorScheme(),
        typography = Typography(),
        shapes = Shapes(),
        motionScheme = MotionScheme.standard(),
        content = { /*content here*/ }
    )

Couleur

Le système de couleurs de M3 est très différent de celui de M2.5. Le nombre de paramètres colorimétriques a augmenté, leurs noms sont différents et ils sont mappés différemment aux composants M3. Dans Compose, cela s'applique à la classe M2.5 Colors, à la classe M3 ColorScheme et aux fonctions associées :

M2.5

import androidx.wear.compose.material.Colors

val appColorScheme: Colors = Colors(
   // M2.5 Color parameters
)

M3

import androidx.wear.compose.material3.ColorScheme
// ...
    val appColorScheme: ColorScheme = ColorScheme(
        // M3 ColorScheme parameters
    )

Le tableau suivant décrit les principales différences entre M2.5 et M3 :

M2.5 M3
Colors A été renommé ColorScheme
13 couleurs 29 couleurs
N/A Nouveau thème de couleurs dynamiques
N/A Nouvelles couleurs tertiaires pour plus d'expression

Thèmes de couleurs dynamiques

La thématisation dynamique des couleurs est une nouvelle fonctionnalité de M3. Si les utilisateurs modifient les couleurs du cadran, les couleurs de l'UI changent en conséquence.

Utilisez la fonction dynamicColorScheme pour implémenter un jeu de couleurs dynamique et fournissez un defaultColorScheme comme solution de remplacement si le jeu de couleurs dynamique n'est pas disponible.

@Composable
fun myApp() {
    val dynamicColorScheme = dynamicColorScheme(LocalContext.current)
    MaterialTheme(colorScheme = dynamicColorScheme ?: myBrandColors) {}
}

internal val myBrandColors: ColorScheme = ColorScheme( /* Specify colors here */)

Typographie

Le système typographique de M3 est différent de celui de M2.5 et inclut les fonctionnalités suivantes :

  • Neuf nouveaux styles de texte
  • Les polices Flex, qui permettent de personnaliser les échelles de caractères pour différentes épaisseurs, largeurs et rondeurs
  • AnimatedText, qui utilise des polices flexibles

M2.5

import androidx.wear.compose.material.Typography

val Typography = Typography(
   // M2.5 TextStyle parameters
)

M3

import androidx.wear.compose.material3.Typography

val Typography = Typography(
    // M3 TextStyle parameters
)

Polices Flex

Les polices Flex permettent aux concepteurs de spécifier la largeur et l'épaisseur du type pour des tailles spécifiques.

Styles de texte

Les TextStyles suivants sont disponibles dans M3. Elles sont utilisées par défaut par différents composants M3.

Typographie TextStyle
Écran displayLarge, displayMedium, displaySmall
Titre titleLarge, titleMedium, titleSmall
Libellé labelLarge, labelMedium, labelSmall
Body bodyLarge, bodyMedium, bodySmall, bodyExtraSmall
Chiffre numeralExtraLarge, numeralLarge, numeralMedium, numeralSmall, numeralExtraSmall
Arc arcLarge, arcMedium, arcSmall

Forme

Le système de formes de M3 est différent de celui de M2.5. Le nombre de paramètres de forme a augmenté, leurs noms sont différents et ils sont mappés différemment aux composants M3. Les tailles de forme suivantes sont disponibles :

  • Très petite
  • Petite
  • Moyenne
  • Grande
  • Très grand

Dans Compose, cela s'applique à la classe M2.5 Shapes et à la classe M3 Shapes :

M2.5

import androidx.wear.compose.material.Shapes

val Shapes = Shapes(
   // M2.5 Shapes parameters
)

M3

import androidx.wear.compose.material3.Shapes

val Shapes = Shapes(
    // M3 Shapes parameters
)

Utilisez le mappage des paramètres de formes de Passer de Material 2 à Material 3 dans Compose comme point de départ.

Morphing de forme

M3 introduit le morphing de forme : les formes se transforment désormais en réponse aux interactions.

Le comportement de morphing de forme est disponible en tant que variante sur un certain nombre de boutons ronds. Consultez la liste suivante des boutons compatibles avec le morphing de forme :

Boutons Fonction de morphing de forme
IconButton IconButtonDefaults.animatedShapes anime le bouton d'icône lorsque l'utilisateur appuie dessus.
IconToggleButton IconToggleButtonDefaults.animatedShapes anime le bouton d'activation de l'icône lorsque l'utilisateur appuie dessus et
IconToggleButtonDefaults.variantAnimatedShapes anime le bouton d'activation de l'icône lorsque l'utilisateur appuie dessus et coche/décoche la case.
TextButton TextButtonDefaults.animatedShapes anime le bouton de texte lorsque l'utilisateur appuie dessus.
TextToggleButton TextToggleButtonDefaults.animatedShapes anime le bouton d'activation/de désactivation du texte lorsque l'utilisateur appuie dessus, et TextToggleButtonDefaults.variantAnimatedShapes anime le bouton d'activation/de désactivation du texte lorsque l'utilisateur appuie dessus et coche/décoche la case.

Composants et mise en page

La plupart des composants et mises en page de M2.5 sont disponibles dans M3. Cependant, certains composants et mises en page M3 n'existaient pas dans M2.5. De plus, certains composants M3 présentent plus de variantes que leurs équivalents dans M2.5.

Bien que certains composants nécessitent une attention particulière, les mappages de fonctions suivants sont recommandés pour commencer :

Material 2.5 Material 3
androidx.wear.compose.material.dialog.Alert androidx.wear.compose.material3.AlertDialog
androidx.wear.compose.material.Button androidx.wear.compose.material3.IconButton ou androidx.wear.compose.material3.TextButton
androidx.wear.compose.material.Card androidx.wear.compose.material3.Card
androidx.wear.compose.material.TitleCard androidx.wear.compose.material3.TitleCard
androidx.wear.compose.material.AppCard androidx.wear.compose.material3.AppCard
androidx.wear.compose.material.Checkbox Aucun équivalent M3, migrer vers androidx.wear.compose.material3.CheckboxButton ou androidx.wear.compose.material3.SplitCheckboxButton
androidx.wear.compose.material.Chip androidx.wear.compose.material3.Button ou
androidx.wear.compose.material3.OutlinedButton ou
androidx.wear.compose.material3.FilledTonalButton ou
androidx.wear.compose.material3.ChildButton
androidx.wear.compose.material.CompactChip androidx.wear.compose.material3.CompactButton
androidx.wear.compose.material.InlineSlider androidx.wear.compose.material3.Slider
androidx.wear.compose.material.LocalContentAlpha() Suppression, car non utilisé par Text ou Icon dans Material 3
androidx.wear.compose.material.PositionIndicator androidx.wear.compose.material3.ScrollIndicator
androidx.wear.compose.material.RadioButton Aucun équivalent M3, migrer vers androidx.wear.compose.material3.RadioButton ou androidx.wear.compose.material3.SplitRadioButton
androidx.wear.compose.material.SwipeToRevealCard androidx.wear.compose.material3.SwipeToReveal
androidx.wear.compose.material.SwipeToRevealChip androidx.wear.compose.material3.SwipeToReveal
androidx.wear.compose.material.Scaffold androidx.wear.compose.material3.AppScaffold et androidx.wear.compose.material3.ScreenScaffold
androidx.wear.compose.material.SplitToggleChip Pas d'équivalent M3, migrez vers androidx.wear.compose.material3.SplitCheckboxButton, androidx.wear.compose.material3.SplitSwitchButton ou androidx.wear.compose.material3.SplitRadioButton
androidx.wear.compose.material.Switch Aucun équivalent M3, migrer vers androidx.wear.compose.material3.SwitchButton ou androidx.wear.compose.material3.SplitSwitchButton
androidx.wear.compose.material.ToggleButton androidx.wear.compose.material3.IconToggleButton ou androidx.wear.compose.material3.TextToggleButton
androidx.wear.compose.material.ToggleChip androidx.wear.compose.material3.CheckboxButton ou
androidx.wear.compose.material3.RadioButton ou
androidx.wear.compose.material3.SwitchButton
androidx.wear.compose.material.Vignette Supprimé, car non inclus dans le design Material 3 Expressive pour Wear OS

Voici une liste des composants Material 3 courants et de leurs équivalents Material 2.5 :

Material 3 Composant équivalent Material 2.5 (s'il n'est pas nouveau dans M3)
androidx.wear.compose.material3.AlertDialog androidx.wear.compose.material.dialog.Alert
androidx.wear.compose.material3.AnimatedPage Nouveau
androidx.wear.compose.material3.AnimatedText Nouveau
androidx.wear.compose.material3.AppScaffold androidx.wear.compose.material.Scaffold (avec androidx.wear.compose.material3.ScreenScaffold)
androidx.wear.compose.material3.Button androidx.wear.compose.material.Chip
androidx.wear.compose.material3.ButtonGroup Nouveau
androidx.wear.compose.material3.Card androidx.wear.compose.material.Card
androidx.wear.compose.material3.CheckboxButton androidx.wear.compose.material.ToggleChip avec un bouton d'activation/de désactivation de case à cocher
androidx.wear.compose.material3.ChildButton androidx.wear.compose.material.Chip (uniquement lorsqu'aucun arrière-plan n'est requis)
androidx.wear.compose.material3.CircularProgressIndicator androidx.wear.compose.material.CircularProgressIndicator
androidx.wear.compose.material3.CompactButton androidx.wear.compose.material.CompactChip
androidx.wear.compose.material3.ConfirmationDialog androidx.wear.compose.material.dialog.Confirmation
androidx.wear.compose.material3.curvedText androidx.wear.compose.material.curvedText
androidx.wear.compose.material3.DatePicker Nouveau
androidx.wear.compose.material3.Dialog androidx.wear.compose.material.dialog.Dialog
androidx.wear.compose.material3.EdgeButton Nouveau
androidx.wear.compose.material3.FadingExpandingLabel Nouveau
androidx.wear.compose.material3.FilledTonalButton androidx.wear.compose.material.Chip lorsqu'un arrière-plan de bouton tonal est requis
androidx.wear.compose.material3.HorizontalPageIndicator androidx.wear.compose.material.HorizontalPageIndicator
androidx.wear.compose.material3.HorizontalPagerScaffold Nouveau
androidx.wear.compose.material3.Icon androidx.wear.compose.material.Icon
androidx.wear.compose.material3.IconButton androidx.wear.compose.material.Button
androidx.wear.compose.material3.IconToggleButton androidx.wear.compose.material.ToggleButton
androidx.wear.compose.material3.LevelIndicator Nouveau
androidx.wear.compose.material3.LinearProgressIndicator Nouveau
androidx.wear.compose.material3.ListHeader androidx.wear.compose.material.ListHeader
androidx.wear.compose.material3.ListSubHeader Nouveau
androidx.wear.compose.material3.MaterialTheme androidx.wear.compose.material.MaterialTheme
androidx.wear.compose.material3.OpenOnPhoneDialog Nouveau
androidx.wear.compose.material3.Picker androidx.wear.compose.material.Picker
androidx.wear.compose.material3.PickerGroup androidx.wear.compose.material.PickerGroup
androidx.wear.compose.material3.RadioButton androidx.wear.compose.material.ToggleChip avec une case d'option
androidx.wear.compose.material3.ScreenScaffold androidx.wear.compose.material.Scaffold (avec androidx.wear.compose.material3.AppScaffold)
androidx.wear.compose.material3.ScrollIndicator androidx.wear.compose.material.PositionIndicator
androidx.wear.compose.material3.scrollAway androidx.wear.compose.material.scrollAway
androidx.wear.compose.material3.SegmentedCircularProgressIndicator Nouveau
androidx.wear.compose.material3.Slider androidx.wear.compose.material.InlineSlider
androidx.wear.compose.material3.SplitRadioButton androidx.wear.compose.material.SplitToggleChip
androidx.wear.compose.material3.SplitCheckboxButton androidx.wear.compose.material.SplitToggleChip
androidx.wear.compose.material3.SplitSwitchButton androidx.wear.compose.material.SplitToggleChip
androidx.wear.compose.material3.Stepper androidx.wear.compose.material.Stepper
androidx.wear.compose.material3.SwipeToDismissBox androidx.wear.compose.material.SwipeToDismissBox
androidx.wear.compose.material3.SwipeToReveal androidx.wear.compose.material.SwipeToRevealCard et androidx.wear.compose.material.SwipeToRevealChip
androidx.wear.compose.material3.SwitchButton androidx.wear.compose.material.ToggleChip avec un bouton bascule
androidx.wear.compose.material3.Text androidx.wear.compose.material.Text
androidx.wear.compose.material3.TextButton androidx.wear.compose.material.Button
androidx.wear.compose.material3.TextToggleButton androidx.wear.compose.material.ToggleButton
androidx.wear.compose.material3.TimeText androidx.wear.compose.material.TimeText
androidx.wear.compose.material3.VerticalPagerScaffold Nouveau

Enfin, voici une liste de certains composants pertinents de la bibliothèque Wear Compose Foundation :

Wear Compose Foundation 1.7.1
androidx.wear.compose.foundation.hierarchicalFocusGroup Utilisé pour annoter les composables d'une application, afin de suivre la partie active de la composition et de coordonner la sélection.
androidx.wear.compose.foundation.pager.HorizontalPager Un pager à défilement horizontal, basé sur les composants Compose Foundation avec des améliorations spécifiques à Wear pour améliorer les performances et le respect des consignes Wear OS.
androidx.wear.compose.foundation.pager.VerticalPager Un pager à défilement vertical, basé sur les composants Compose Foundation avec des améliorations spécifiques à Wear pour améliorer les performances et le respect des consignes Wear OS.
androidx.wear.compose.foundation.lazy.TransformingLazyColumn Peut être utilisé à la place de ScalingLazyColumn pour ajouter des effets de transformation de défilement à chaque élément.

Boutons

Les boutons de M3 sont différents de ceux de M2.5. La puce M2.5 a été remplacée par un bouton. L'implémentation de Button fournit des valeurs par défaut pour Text, maxLines et textAlign. Ces valeurs par défaut peuvent être remplacées dans l'élément Text.

M2.5

import androidx.wear.compose.material.Chip

//M2.5 Buttons
Chip(...)
CompactChip(...)
Button(...)

M3

//M3 Buttons
Button(onClick = { }){}
CompactButton(onClick = { }){}
IconButton(onClick = { }){}
TextButton(onClick = { }){}

M3 inclut également de nouvelles variantes des boutons. Vous en trouverez une description dans la présentation de la documentation de référence de l'API Compose Material 3.

M3 introduit un nouveau bouton : EdgeButton. EdgeButton est disponible en quatre tailles différentes : XS, S, M et L. L'implémentation de EdgeButton fournit une valeur par défaut pour maxLines en fonction de la taille, qui peut être personnalisée.

Si vous utilisez TransformingLazyColumn ou ScalingLazyColumn, transmettez EdgeButton dans ScreenScaffold pour qu'il se transforme et change de forme lors du défilement, au lieu d'ajouter un EdgeButton comme dernier élément de la liste. Consultez le code suivant pour savoir comment utiliser EdgeButton avec ScreenScaffold et TransformingLazyColumn.

val state = rememberTransformingLazyColumnState()
ScreenScaffold(
    scrollState = state,
    edgeButton = {
        EdgeButton(
            onClick = { },
            modifier = Modifier.scrollable(
                state,
                orientation = Orientation.Vertical,
                reverseDirection = true,
                // Apply overscroll to the EdgeButton for proper scrolling behavior.
                overscrollEffect = rememberOverscrollEffect(),
            ),
        ) {
            Text(stringResource(R.string.show))
        }
    },
) { contentPadding ->
    TransformingLazyColumn(state = state, contentPadding = contentPadding) {
        // additional code here
        // ...
    }
}

Scaffold

Les échafaudages de M3 sont différents de ceux de M2.5. Dans M3, AppScaffold et le nouveau composable ScreenScaffold ont remplacé Scaffold. AppScaffold et ScreenScaffold forment la structure d'un écran et coordonnent les transitions des composants ScrollIndicator et TimeText.

AppScaffold permet aux éléments d'écran statiques tels que TimeText de rester visibles lors des transitions dans l'application, comme pour le balayage pour ignorer. Il fournit un emplacement pour le contenu principal de l'application, qui est généralement fourni par un composant de navigation tel que SwipeDismissableNavHost.

Vous déclarez un AppScaffold pour l'activité et utilisez un ScreenScaffold pour chaque écran. AppScaffold ajoute un composant TimeText par défaut aux écrans. Vous pouvez la remplacer si vous souhaitez la personnaliser à l'aide du paramètre timeText.

M2.5

import androidx.wear.compose.material.Scaffold

Scaffold {...}

M3

    AppScaffold {
        val navController = rememberSwipeDismissableNavController()
        SwipeDismissableNavHost(
            navController = navController,
            startDestination = "message_list"
        ) {
            composable("message_list") {
                MessageList(onMessageClick = { id ->
                    navController.navigate("message_detail/$id")
                })
            }
            composable("message_detail/{id}") {
                MessageDetail(id = it.arguments?.getString("id")!!)
            }
        }
    }
}

// Implementation of one of the screens in the navigation
@Composable
fun MessageDetail(id: String) {
    // .. Screen level content goes here
    val scrollState = rememberTransformingLazyColumnState()
    val transformationSpec = rememberTransformationSpec()

    ScreenScaffold(
        scrollState = scrollState,
    ) { contentPadding ->
        // Screen content goes here
        // ...

Si vous utilisez un HorizontalPager avec HorizontalPageIndicator, vous pouvez migrer vers HorizontalPagerScaffold. HorizontalPagerScaffold est placé dans un AppScaffold. AppScaffold et HorizontalPagerScaffold forment la structure d'un Pager et coordonnent les transitions des composants HorizontalPageIndicator et TimeText.

HorizontalPagerScaffold affiche le HorizontalPageIndicator au centre de l'écran par défaut, et coordonne l'affichage et le masquage de TimeText et HorizontalPageIndicator selon que le Pager est paginé ou non, ce qui est déterminé par le PagerState.

Il existe également un nouveau composant AnimatedPage, qui anime une page dans un Pager avec un effet de mise à l'échelle et de scrim en fonction de sa position.

AppScaffold {
    val pagerState = rememberPagerState(pageCount = { 10 })

    HorizontalPagerScaffold(pagerState = pagerState) {
        HorizontalPager(
            state = pagerState,
            flingBehavior =
                PagerScaffoldDefaults.snapWithSpringFlingBehavior(
                    state = pagerState
                ),
        ) { page ->
            AnimatedPage(pageIndex = page, pagerState = pagerState) {
                val columnState = rememberTransformingLazyColumnState()
                val transformationSpec = rememberTransformationSpec()

                ScreenScaffold(
                    scrollState = columnState,
                ) { contentPadding ->
                    TransformingLazyColumn(
                        state = columnState,
                        contentPadding = contentPadding,
                    ) {
                        item {
                            ListHeader(
                                modifier = Modifier
                                    .fillMaxWidth()
                                    .transformedHeight(this, transformationSpec)
                                    .minimumVerticalContentPadding(
                                        ListHeaderDefaults.minimumTopListContentPadding
                                    ),
                                transformation = SurfaceTransformation(transformationSpec),
                            ) {
                                Text(text = "Pager sample")
                            }
                        }
                        item {
                            Card(
                                modifier = Modifier
                                    .fillMaxWidth()
                                    .transformedHeight(this, transformationSpec)
                                    .minimumVerticalContentPadding(
                                        CardDefaults.minimumVerticalListContentPadding
                                    ),
                                transformation = SurfaceTransformation(transformationSpec),
                            ) {
                                if (page == 0) {
                                    Text(text = "Page #$page. Swipe right")
                                } else {
                                    Text(text = "Page #$page. Swipe left and right")
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}

Enfin, M3 introduit un VerticalPagerScaffold qui suit le même modèle que HorizontalPagerScaffold :

@Composable
fun VerticalPagerScaffoldSample() {
    AppScaffold {
        val pagerState = rememberPagerState(pageCount = { 10 })

        VerticalPagerScaffold(pagerState = pagerState) {
            VerticalPager(
                state = pagerState,
                flingBehavior =
                    PagerScaffoldDefaults.snapWithSpringFlingBehavior(
                        state = pagerState
                    ),
            ) { page ->
                AnimatedPage(pageIndex = page, pagerState = pagerState) {
                    ScreenScaffold {
                        Column(
                            modifier = Modifier.fillMaxSize(),
                            horizontalAlignment = Alignment.CenterHorizontally,
                            verticalArrangement = Arrangement.Center,
                        ) {
                            Text(text = "Page #$page")
                            Spacer(modifier = Modifier.height(8.dp))
                            Text(text = "Swipe up and down")
                        }
                    }
                }
            }
        }
    }
}

Espace réservé

Certaines API ont été modifiées entre M2.5 et M3. M3 fournit deux modificateurs d'espace réservé :

  • Modifier.placeholder, qui est dessiné à la place du contenu qui n'est pas encore chargé
  • Un effet de miroitement d'espace réservé Modifier.placeholderShimmer qui fournit un effet de miroitement d'espace réservé qui s'exécute dans une boucle d'animation en attendant que les données se chargent.

Consultez le tableau suivant pour connaître les autres modifications apportées au composant Placeholder.

M2.5 M3
PlaceholderState.startPlaceholderAnimation A été supprimé
PlaceholderState.placeholderProgression A été supprimé
PlaceholderState.isShowContent Remplacé par PlaceholderState.isVisible (booléen inversé)
PlaceholderState.isWipeOff A été supprimé
PlaceholderDefaults.painterWithPlaceholderOverlayBackgroundBrush A été supprimé
PlaceholderDefaults.placeholderBackgroundBrush A été supprimé
PlaceholderDefaults.placeholderChipColors A été supprimé

SwipeDismissableNavHost

SwipeDismissableNavHost fait partie de wear.compose.navigation. Lorsque ce composant est utilisé avec M3, MaterialTheme M3 met à jour LocalSwipeToDismissBackgroundScrimColor et LocalSwipeToDismissContentScrimColor.

TransformingLazyColumn

TransformingLazyColumn fait partie de androidx.wear.compose.foundation.lazy et ajoute la prise en charge des animations de mise à l'échelle et de morphing sur les éléments de liste pendant le défilement, ce qui améliore l'expérience utilisateur. Nous recommandons vivement aux applications de migrer de ScalingLazyColumn vers TransformingLazyColumn.

Comme ScalingLazyColumn, il fournit rememberTransformingLazyColumnState() pour créer un TransformingLazyColumnState qui est mémorisé dans les compositions.

Pour ajouter des animations de mise à l'échelle et de morphing, ajoutez les éléments suivants à chaque élément de la liste :

  • Modifier.transformedHeight, qui vous permet de calculer la hauteur transformée des éléments à l'aide d'un TransformationSpec, vous pouvez utiliser rememberTransformationSpec(), sauf si vous avez besoin d'une personnalisation supplémentaire.
  • SurfaceTransformation

Pour vérifier que la marge intérieure est correcte en haut et en bas de la liste, utilisez le modificateur minimumVerticalContentPadding.

val columnState = rememberTransformingLazyColumnState()
val transformationSpec = rememberTransformationSpec()
ScreenScaffold(
    scrollState = columnState
) { contentPadding ->
    TransformingLazyColumn(
        state = columnState,
        contentPadding = contentPadding
    ) {
        item {
            ListHeader(
                modifier = Modifier
                    .fillMaxWidth()
                    .transformedHeight(this, transformationSpec)
                    .minimumVerticalContentPadding(ListHeaderDefaults.minimumTopListContentPadding),
                transformation = SurfaceTransformation(transformationSpec)
            ) {
                Text(text = "Header")
            }
        }
        // ... other items
        item {
            Button(
                modifier = Modifier
                    .fillMaxWidth()
                    .transformedHeight(this, transformationSpec)
                    .minimumVerticalContentPadding(ButtonDefaults.minimumVerticalListContentPadding),
                transformation = SurfaceTransformation(transformationSpec),
                onClick = { /* ... */ },
                icon = {
                    Icon(
                        imageVector = Icons.Default.Build,
                        contentDescription = "build",
                    )
                },
            ) {
                Text(
                    text = "Build",
                    maxLines = 1,
                    overflow = TextOverflow.Ellipsis,
                )
            }
        }
    }
}

Pour en savoir plus sur la migration de M2.5 vers M3 dans Compose, consultez les ressources supplémentaires suivantes.

Exemples

Documentation de référence de l'API et code source

Conception