Compose Material 3

Compose Material 3

Guide de l'utilisateur  Exemple de code

Documentation de référence sur l'API
androidx.compose.material3
(Voir la documentation de référence de l'API pour tous les packages Compose)

Création d'UI Jetpack Compose grâce aux composants Material Design 3, la nouvelle évolution de Material Design. Material 3 inclut des thématisations et des composants mis à jour ainsi que des fonctionnalités de personnalisation Material You telles que les couleurs dynamiques. Material 3 est conçu pour correspondre au nouveau style visuel et à l'UI du système Android 12.

Dernière mise à jour	Version stable	Version finale	Version bêta	Version alpha
4 septembre 2024	1.3.0	-	-	-

Structure

Compose est une combinaison de sept ID de groupe Maven dans androidx. chacun contenant un sous-ensemble ciblé de fonctionnalités. Chaque sous-ensemble est associé à son propre ensemble de notes de version.

Ce tableau décrit les différents groupes et renvoie à chaque ensemble de notes de version.

Groupe	Description
compose.animation	Créer des animations dans les applications Jetpack Compose afin d'enrichir l'expérience utilisateur.
compose.compiler	Transformation de fonctions @Composable et prise en charge des optimisations avec un plug-in de compilation en Kotlin.
compose.foundation	Conception d'applications Jetpack Compose avec des composants prêts à l'emploi et extension de la base pour créer vos propres éléments de système de conception.
compose.material	Création d'UI Jetpack Compose avec des composants Material Design prêts à l'emploi. Il s'agit du point d'entrée de niveau supérieur de Compose, conçu pour fournir des composants qui correspondent à ceux décrits sur www.material.io.
compose.material3	Création d'UI Jetpack Compose grâce aux composants Material Design 3, la nouvelle évolution de Material Design. Material 3 inclut des thématisations et des composants mis à jour ainsi que des fonctionnalités de personnalisation Material You telles que les couleurs dynamiques. Material 3 est conçu pour correspondre au nouveau style visuel et à l'UI du système Android 12.
compose.runtime	Composants fondamentaux du modèle de programmation et de la gestion d'état de Compose, et environnement d'exécution principal du plug-in Compose Compiler à cibler.
compose.ui	Composants fondamentaux de l'interface utilisateur de Compose nécessaires pour interagir avec l'appareil, y compris la mise en page, le dessin et la saisie.

Déclarer des dépendances

Pour ajouter une dépendance sur Compose, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.3.0"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.0"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.3.0")
    implementation("androidx.compose.material3:material3-window-size-class:1.3.0")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Compose Material3 Common version 1.0

Version 1.0.0-alpha01

17 avril 2024

Publication d'androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 et androidx.compose.material3:material3-common-desktop:1.0.0-alpha01. La version 1.0.0-alpha01 contient ces commits.

Nouvelles fonctionnalités

Composants sans thème pouvant être utilisés pour créer des composants Material Design:

• Palette tonale <ph type="x-smartling-placeholder">
  </ph>
  • TonalPalette
• Icône
  • Icon
• Taille des zones cibles tactiles <ph type="x-smartling-placeholder">
  </ph>
  • LocalMinimumInteractiveComponentSize

Suite de navigation adaptative Material 3 de Compose version 1.0

Version 1.0.0-alpha07

1er mai 2024

Publication d'androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 et androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07. La version 1.0.0-alpha07 contient ces commits.

Modifications apportées à l'API

• Possibilité de rendre les API de la suite Navigation non expérimentales. (If62af)

Correction de bugs

• Utilisation par défaut des encarts pour le contenu (50266df)

Version 1.0.0-alpha06

17 avril 2024

Publication d'androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 et androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06. La version 1.0.0-alpha06 contient ces commits.

Modifications apportées à l'API

• Ajoutez containerColor et contentColor à NavigationSuiteScaffoldDefaults. (I64e3a, b/331993720).
• Ajout de la fonction itemColors à NavigationSuiteDefaults. (Idf719, b/328480012).
• Fermez NavigationSuiteScope. (Iefa57).

Version 1.0.0-alpha05

6 mars 2024

Publication d'androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 et androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05. La version 1.0.0-alpha05 contient ces commits.

Modifications apportées à l'API

• Rend le constructeur NavigationSuiteItemColors public. (Ica83a, b/324886877).

Version 1.0.0-alpha04

21 février 2024

Publication d'androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 et androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Mises à jour des dépendances

• Mise à jour des dépendances adaptatives Material3 vers les nouveaux chemins d'accès aux modules. (Ibc421).
• Migrez pour utiliser la version des classes de taille de fenêtre du gestionnaire de fenêtres. (I3794d).

Version 1.0.0-alpha03

7 février 2024

Publication d'androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 et androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Modifications apportées à l'API

• Mise à jour du nom du package de navigation-suite vers navigationsuite. (I7eff7)
• Les composants Material3 qui exposent un MutableInteractionSource dans leur API ont été mis à jour pour exposer désormais un MutableInteractionSource pouvant avoir une valeur nulle et dont la valeur par défaut est "null". Il n'y a aucun changement sémantique ici: transmettre la valeur "null" signifie que vous ne souhaitez pas hisser MutableInteractionSource, qui sera créé dans le composant si nécessaire. Si vous passez à une valeur nulle, certains composants ne peuvent jamais allouer de MutableInteractionSource, et les autres composants ne peuvent créer une instance que de manière différée lorsqu'ils en ont besoin, ce qui améliore les performances de ces composants. Si vous n'utilisez pas le MutableInteractionSource que vous transmettez à ces composants, nous vous recommandons de transmettre la valeur "null". Nous vous recommandons également d'apporter les mêmes modifications à vos propres composants. (I41abb, b/298048146).

Version 1.0.0-alpha02

13 décembre 2023

Publication d'androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 et androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Nouvelles fonctionnalités

• Ajouter une "Aucune" NavigationSuiteType (If8cb1, b/313688598)

Correction de bugs

• Correction du composant de navigation qui remplissait l'intégralité de l'écran lorsque la surface racine contenait modifier.fillMaxSize. (c9cf250, b/312664933).

Version 1.0.0-alpha01

15 novembre 2023

Publication d'androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

• NavigationSuiteScaffold <ph type="x-smartling-placeholder">
  </ph>
  • NavigationSuiteScaffoldLayout
  • NavigationSuite

Compose Material3 Adaptive version 1.0

Remarque :Depuis la version 1.0.0-alpha07, androidx.compose.material3:material3-adaptive a été migré vers androidx.compose.material3.adaptive. Pour les futures versions, veuillez utiliser androidx.compose.material3.adaptive et les notes de version associées sur notre page Compose Material3 Adaptive.

Version 1.0.0-alpha06

7 février 2024

Publication d'androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 et androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06.

Nouvelles fonctionnalités

• Ajout d'options de comportement supplémentaires pour le retour arrière dans ThreePaneScaffoldNavigator. (I858aa).
• Ajout d'un contenu facultatif sur la destination à l'historique de navigation. (Ibd7e6).

Version 1.0.0-alpha05

24 janvier 2024

Publication d'androidx.compose.material3:material3-adaptive:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 et androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05

Nouvelles fonctionnalités

• Prise en charge de la prise en charge de l'historique dans la navigation d'échafaudage et le calcul des valeurs. (I71d46)

Version 1.0.0-alpha04

10 janvier 2024

Publication d'androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 et androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Nouvelles fonctionnalités

• Ajout de la compatibilité bord à bord avec les échafaudages de volet. (I1b462)

Modifications apportées à l'API

• Déplacement des propriétés de limite de charnière dans la stratégie vers une liste d'informations sur la charnière. (I24f90)

Correction de bugs

• Correction de AnimatedPane qui n'est pas recomposé. (c3f573d)

Version 1.0.0-alpha03

13 décembre 2023

Publication d'androidx.compose.material3:material3-adaptive:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03 et androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Modifications apportées à l'API

• Remplacez les rôles de l'échafaudage (scaffold) par des alias de ThreePaneScaffoldRole. (I65bd1).
• Création d'une classe de base pour les rôles scaffold. (I4784d)
• Suppression des paramètres inutiles dans le contenu de AnimatedPane. (Ibc73b)
• Renommage de collectWindowSizeAsState et renvoie des valeurs brutes à la place. (I480f4)

Version 1.0.0-alpha02

29 novembre 2023

Publication d'androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 et androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Modifications apportées à l'API

• Séparer les API de navigation des API d'échafaudage adaptatif. (Ic4045).
• Supprimez la classe GutterSize. (I785b3).

Correction de bugs

• Les volets de correction ne sont pas intervertis lorsque AnimatedPane n'est pas utilisé. (d88f181)

Version 1.0.0-alpha01

15 novembre 2023

Publication d'androidx.compose.material3:material3-adaptive:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

API des conditions adaptatives Material3:

• Position

API de directive d'échafaudage du volet adaptatif Material3:

• Directive PaneScaffold <ph type="x-smartling-placeholder">
  </ph>
  • calculateStandardPaneScaffoldDirective
  • calculateDensePaneScaffoldDirective
  • AdaptStrategy
  • ThreePaneScaffoldAdaptStrategies
  • HingePolicy

API d'échafaudage du volet adaptatif Material3:

• API de base pour échafaudage de volet <ph type="x-smartling-placeholder">
  </ph>
  • PaneScaffoldScope
  • ThreePaneScaffoldRole
  • PaneAdaptedValue
  • ThreePaneScaffoldValue
  • calculateThreePaneScaffoldValue
  • AnimatedPane

Compose Material3 version 1.3

Version 1.3.0

4 septembre 2024

Publication d'androidx.compose.material3:material3-*:1.3.0. La version 1.3.0 contient ces commits.

Changements importants depuis la version 1.2.0

Principales fonctionnalités de la version 1.3.0

Nouveaux composants Material Design 3

• Carrousel <ph type="x-smartling-placeholder">
  </ph>
  • HorizontalMultiBrowseCarousel et HorizontalUncontainedCarousel Améliorations apportées aux composants Material Design 3 existants.
• [ModalBottomSheet] prend désormais en charge la prévisualisation du Retour sur U+. (Iccf32, b/281967264, b/304850357)
• [SearchBar] est désormais compatible avec la prévisualisation du Retour sur U+. (I657f8)
• Le panneau de navigation (ModalDrawerSheet et DismissibleDrawerSheet) est désormais compatible avec la prévisualisation du Retour sur U+ si vous l'activez. (Ie5b0b)
• DropdownMenu prend désormais en charge la couleur, la forme, l'élévation et la bordure personnalisées. (I8e981,b/289554448, b/301887035, b/283654243).
• Mise à jour du curseur pour améliorer l'accessibilité grâce à l'ajout d'indicateurs d'intervalle et d'arrêt. (I3058e).
• Mise à jour de ProgressIndicator pour améliorer l'accessibilité en ajoutant un indicateur d'intervalle et d'arrêt. (I21451).
• Ajout d'un curseur de saisie par défaut pour l'info-bulle enrichie. Prise en charge du curseur de saisie personnalisé pour l'ancrage LayoutCoordinates. (Ifd42c). Modifications destructives
• Nouvelles API pull-to-refresh: <ph type="x-smartling-placeholder">
  </ph>
  • Simplification de PullToRefreshState pour utiliser des valeurs fractionnaires au lieu d'unités dp.
  • L'état de isRefreshing est contrôlé par l'utilisateur au lieu de PullToRefreshState.
  • Séparation de la connexion de défilement imbriqué de PullToRefreshState. Elle est gérée par le nouveau PullToRefreshBox ou Modifier.pullToRefresh.
  • Cette mise à jour constitue une modification destructive des API expérimentales précédentes. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Modifications destructives visuelles
• Mettez à jour la superposition de l'état de la mise au point sur 0,1 f pour garantir un contraste suffisant des couleurs. (I7ea77).
• Légers ajustements apportés aux couleurs de surface et d'arrière-plan par défaut dans lightColorScheme et darkColorScheme. (I9db52).
• Mise à jour des couleurs du curseur et de ProgressIndicator pour respecter les nouvelles spécifications de contraste non textuel. (I26807).
• Les variantes SurfaceContainer sont désormais utilisées par les composants. Les composants qui calculent formellement la couleur avec Surface et TonalElevation utilisent désormais les rôles SurfaceContainer par défaut, qui ne sont pas affectés par l'élévation tonale. (b/304584161).
• Les rôles de référence des conteneurs "Surface" et "Surface" ont été légèrement ajustés, ce qui permet d'obtenir davantage de teinte dans les thèmes clair et sombre. (I677a5).
• Les API expérimentales sont devenues stables.
• Amélioration des performances

Version 1.3.0-rc01

21 août 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-rc01. La version 1.3.0-rc01 contient ces commits.

Correction de bugs

• ModalBottomSheet apparaît désormais en premier dans l'ordre de traversée sémantique, suivi du fond. (I436f9, b/358594665).

Version 1.3.0-beta05

24 juillet 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-beta05. La version 1.3.0-beta05 contient ces commits.

• Résolution du problème dans le cadre duquel le contenu BottomSheet était manquant ou tronqué sur Android N et O. (a10a2d)
• Augmentation des limites sémantiques du curseur pour que TalkBack affiche correctement les indicateurs de mise au point autour des pouces. (0b5a1d).

Version 1.3.0-beta04

26 juin 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-beta04. La version 1.3.0-beta04 contient ces commits.

Version 1.3.0-beta03

12 juin 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-beta03. La version 1.3.0-beta03 contient ces commits.

Contribution externe

• Mise à disposition de androidx.compose.material3.DropdownMenu à partir d'un ensemble de sources commun. (If62c0).

Version 1.3.0-beta02

29 mai 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-beta02. La version 1.3.0-beta02 contient ces commits.

Modifications apportées à l'API

• Modifier.pullToRefreshIndicator prend en charge l'élévation. Mettez à jour les API Pull to Refresh pour qu'elles soient activées en tant que valeur booléenne plutôt qu'en lambda. Prise en charge de l'alignement de contenu dans PullToRefreshBox. (I75679)
• Faire de TooltipScope une interface scellée, et créer une implémentation interne à utiliser dans TooltipBox et les étiquettes. (I3833e).
• Ajout de deux nouveaux modificateurs à CarouselItemScope, maskClip et maskBorder, pour ajouter facilement une forme et une bordure à n'importe quel élément du carrousel. (Id67a1)
• TimePickerState est désormais une interface qui permet de définir l'heure. (I88546)
• Mise à jour de l'API pour styliser les liens: déplacement de TextLinkStyles vers TextStyle et suppression de TextDefaults dans le contenu. (I5477b).

Correction de bugs

• Les icônes d'état et de barre de navigation de ModalBottomSheet répondent désormais à l'état du thème sombre. (Ie1fe7, b/338342149).
• Ajout de la sémantique de fermeture de feuille au fond ModalBottomSheet. (0e61cb,b/328801864).

Contribution externe

• Mise à disposition de androidx.compose.material3.AlertDialog à partir d'un ensemble de sources commun. (Ia33f5)
• Mise à disposition de ModalBottomSheet à partir d'un ensemble de sources commun. (Id7cc7)

Version 1.3.0-beta01

14 mai 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-beta01. La version 1.3.0-beta01 contient ces commits.

Modifications apportées à l'API

• Utilisation de DpSize au lieu de CaretProperties. Suppression de CaretProperties... Remplacement du nom CaretScope par TooltipScope. (Id9a76).
• Mise à jour de l'API permettant d'obtenir des liens sur le thème Material dans le texte. Plus précisément, suppression des méthodes de TextDefaults pour créer des LinkAnnotations thématiques et analyser le code HTML avec des liens thématiques. À la place, nous avons ajouté une classe TextLinkStyles qui permet de styliser les liens en tant que paramètre du composable Text. (I31b93).

Version 1.3.0-alpha06

1er mai 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-alpha06. La version 1.3.0-alpha06 contient ces commits.

Modifications destructives

• Nouvelles API pull-to-refresh:

  • Simplification de PullToRefreshState pour utiliser des valeurs fractionnaires au lieu d'unités dp.
  • L'état de isRefreshing est contrôlé par l'utilisateur au lieu de PullToRefreshState.
  • Séparation de la connexion de défilement imbriqué de PullToRefreshState. Elle est gérée par le nouveau PullToRefreshBox ou Modifier.pullToRefresh.
  • Cette mise à jour constitue une modification destructive des API expérimentales précédentes. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)

Modifications apportées à l'API

• RippleConfiguration#isEnabled a été supprimé et LocalRippleConfiguration peut désormais avoir une valeur nulle. Pour désactiver une ondulation, au lieu de fournir un RippleConfiguration avec isEnabled = false, fournissez null à LocalRippleConfiguration. (I22725).
• ModalBottomSheet dessine plus précisément le fond sur la barre d'état lorsque l'option "Bord à bord" est activée. Le contenu modal de la bottom sheet peut désormais utiliser des encarts de fenêtre, ce qui permet d'afficher le contenu visible au-dessus de la barre de navigation. Le paramètre windowInsets de ModalBottomSheet a été renommé contentWindowInsets pour spécifier l'endroit où les encarts seront appliqués. Ceux-ci ne sont plus liés à la logique de fenêtre. Le type contentWindowInsets a été remplacé par une fonction qui renvoie WindowInsets pour pouvoir être résolu dans une nouvelle fenêtre. (I39630, b/274872542, b/300280229, b/290893168)
• PrimaryScrollableTabRow et SecondaryScrollableTabRow utilisent désormais une mise en page personnalisée au lieu de la sous-composition, ce qui devrait améliorer les performances. (I991e0).
• L'option de style "En appuyant sur les liens de texte" est disponible en plus du style normal. Les méthodes TextDefaults ont chacune obtenu un argument pressedStyle pour l'accepter. (Ic473f, b/139312671).

Correction de bugs

• Les ancres de déplacement du panneau de navigation correspondent désormais à la largeur de drawerContent. (Ibc72f, b/245355396).
• La marge intérieure supérieure de OutlinedTextField pour le libellé tient désormais compte de la taille de la police système. (Idc781).
• Correction de l'emplacement du package de CalendarLocale. (Ifa235).
• [Prédiction du Retour] Mise à jour des animations de la prévisualisation du Retour pour utiliser la courbe d'interpolation de (0,1, 0,1, 0, 1). (I2591a)

Version 1.3.0-alpha05

17 avril 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-alpha05. La version 1.3.0-alpha05 contient ces commits.

Nouvelles fonctionnalités

• SearchBar et DockedSearchBar comportent de nouvelles surcharges qui acceptent un paramètre de champ de texte. Cela permet de styliser le champ de texte séparément du reste de la barre de recherche et de transmettre des champs de texte personnalisés. Le champ de texte de l'implémentation actuelle est désormais disponible en tant que SearchBarDefaults.InputField. (I50c73, b/275074248, b/278773336, b/326627700)
• Ajout du lambda drawTick à l'API publique afin de personnaliser les ticks si nécessaire. (I0c048)

Modifications apportées à l'API

• Option de style d'état "Pressé" pour les liens textuels en plus du style normal, survolés et ciblés. (I5f864, b/139312671)
• Mise à jour de CarouselItemInfo pour exposer un masque Rect par lequel l'élément est rogné. (I785d8)
• Suppression de BasicTooltipState de l'API publique Material 3. Sa fonctionnalité est combinée à TooltipState jusqu'à ce que l'élément BasicTooltip de l'élément de base soit stabilisé. (Icda29).
• Ajout d'un objet TextDefaults contenant des méthodes pour construire une LinkAnnotation et analyser la chaîne taguée HTML qui applique MaterialTheme aux liens. (I98532, b/139312671)
• ExposedDropdownMenuBoxScope n'autorise plus les sous-classes. Les menus déroulants exposés comportent désormais un MenuAnchorType qui doit être transmis à menuAnchor pour offrir une meilleure accessibilité. Il doit être utilisé au lieu de transmettre focusable à ExposedDropdownMenu, qui est désormais obsolète. menuAnchor dispose d'un nouveau paramètre permettant de contrôler l'état de enabled. (I55ee6, b/257209915, b/308840226).
• Correction de la couleur de bordure de OutlinedButton lorsqu'elle est désactivée. Ajout d'une surcharge ButtonDefaults.outlinedButtonBorder("enabled") qui prend l'état activé. (Ie650b, b/318461363).
• Ajout d'une classe CarouselItemInfo pour aider les clients à obtenir des informations sur les tailles des articles. (I9070c).
• Abandon du constructeur ColorScheme sans conteneurs de surface. Veuillez migrer vers le constructeur qui inclut les conteneurs de surface. (I35c11).
• [Contours]TextFieldDefaults ContainerBox a été renommé Container. (Ie8d3b).

Correction de bugs

• BottomSheetScaffold ne défile plus à partir du défilement imbriqué si sheetSwipeEnabled est défini sur "false". (I5e1c1, b/306464779).
• Suppression d'une annotation d'activation ExperimentalMaterial3Api dans IconButtonSamples.kt. (I111d1).

Version 1.3.0-alpha04

3 avril 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-alpha04. La version 1.3.0-alpha04 contient ces commits.

Nouvelles fonctionnalités

• Ajout de deux versions expérimentales du carrousel Material3 : HorizontalMultiBrowseCarousel et HorizontalUncontainedCarousel. (I88d64)
• Mise à jour du panneau de navigation de Compose M3 (ModalDrawerSheet et DismissibleDrawerSheet) pour prendre en charge la prévisualisation du Retour sur U+ en tant qu'activation. (Ie5b0b)
• Ajout d'une API dans Icon pour permettre la transmission de la teinte des couleurs en tant que lambda afin d'éviter toute recomposition. (I5b5a2).
• Les API de la barre d'application supérieure acceptent désormais les hauteurs personnalisées pour les sections fixes et réductibles. (Ib8b0c, b/323403446).

Modifications apportées à l'API

• Les API de la barre d'application supérieure acceptent désormais les hauteurs personnalisées pour les sections fixes et réductibles. Correction d'un problème qui entraînait trop de recomposition des barres d'application supérieures d'une seule ligne lors du défilement du contenu. Correction d'un problème qui provoquait la troncation de MediumTopAppBar titres sur les appareils avec de grands paramètres de police/d'affichage. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676)
• SegmentedButton et les API associées sont désormais stables. (I8a158)
• SwipeToDismissBox, SwipeToDismissBoxDefaults, SwipeToDismissBoxState et SwipeToDismissBoxValue sont désormais stables. (I5f000).
• Suppression des API et des énumérations DismissDirection et DismissValue, devenues obsolètes. (I89ccd).
• Ajout d'une balise expérimentale à l'objet associé CarouselState de carrousel. (I94154).
• Abandon de LocalMinimumInteractiveComponentEnforcement et ajout de LocalMinimumInteractiveComponentSize pour le remplacer. (I7a7ac).
• Le constructeur SearchBarColors est désormais public. (I769ca).
• Ajout d'un paramètre gesturesEnabled à SwipeToDismissBox. (Idc59f, b/324170119).
• Suppression des API de champs de texte marquées comme obsolètes et expérimentales. (I1305f).

Version 1.3.0-alpha03

20 mars 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-alpha03. La version 1.3.0-alpha03 contient ces commits.

Modifications destructives visuelles

• Mettez à jour la superposition de l'état de la mise au point sur 0,1 f pour garantir un contraste suffisant des couleurs. (I7ea77).
• Légers ajustements apportés aux couleurs de surface et d'arrière-plan par défaut dans lightColorScheme et darkColorScheme. (I9db52).

Nouvelles fonctionnalités

• Ajout de paramètres pour personnaliser ExposedDropdownMenu. En particulier, les menus comportent désormais un paramètre focusable (true par défaut) qui doit être défini sur false lorsque vous utilisez des champs de texte modifiables. (I4184c, b/323694447, b/278609042).

Modifications apportées à l'API

• L'option ScaffoldSubcomposeInMeasureFix a été supprimée. (Ie2a4b).
• NavigationRailItemColors est désormais marqué comme @Immutable. (If6112, b/327660613).
• NavigationBarItemColors est désormais marqué comme @Immutable. (I42a30, b/298064514).
• Réorganisez les paramètres dans le composable "Slider Track". (I9f315).
• ExposedDropdownMenu est désormais implémenté à l'aide de Popup. Le comportement devrait être le même, sauf que les menus sélectionnables avec des champs de texte modifiables peuvent être masqués lors de la saisie au clavier.

Correction de bugs

• Les rôles de référence des conteneurs "Surface" et "Surface" ont été légèrement ajustés, ce qui permet d'obtenir davantage de teinte dans les thèmes clair et sombre. (I677a5).
• Mise à jour des couleurs du curseur et de ProgressIndicator pour respecter les nouvelles spécifications de contraste non textuel. (I26807).
• Mettez à jour la superposition de l'état de la mise au point sur 0,1 f pour garantir un contraste suffisant des couleurs. (I7ea77).
• Légers ajustements apportés aux couleurs de surface et d'arrière-plan par défaut dans lightColorScheme et darkColorScheme. (I9db52).

Version 1.3.0-alpha02

6 mars 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-alpha02. La version 1.3.0-alpha02 contient ces commits.

Modifications apportées à l'API

• Stabilité des états du curseur. Redéfinir la valeur de State.onValueChangeFinished. Encapsuler onValueChangeFinished dans un rememberUpdatedState. (I82ab2, b/322269951).
• Les composants Navigation utilisent désormais les nouveaux rôles SurfaceContainer. DrawerDefaults fournit désormais des attributs standardContainerColor et modalContainerColor distincts. DrawerDefaults.ModalDrawerElevation est désormais 0.dp. (I7fbac).
• Suppression de @Stable des états de Slider, car nous avons remplacé state.onValueChangeFinished par var. (Ied34a, b/322269951).
• Les spécifications d'animation ModalBottomSheet et StandardBottomSheet sont désormais un TweenSpec, mise à jour à partir d'une animation de rétroaction. Cela permet de résoudre un problème de dépassement visible. Suppression des constructeurs SheetState obsolètes sans densité. (I7babc, b/285847707).

Correction de bugs

• Les variantes SurfaceContainer sont désormais utilisées par les composants. Les composants qui calculent formellement la couleur avec Surface et TonalElevation utilisent désormais les rôles SurfaceContainer par défaut, qui ne sont pas affectés par l'élévation tonale. (b/304584161).
• Correction d'un bug qui provoquait le noir pour la couleur du conteneur non sélectionnée et désactivée de ElevatedFilterChip. (I400e6, b/322407043).
• Correction de l'indicateur de progression indéterminé lorsque la progression est nulle. (Id6582)
• Correction d'un problème avec Slider et RangeSlider sur la mise en page de droite à gauche. (Iab0e1)
• Ajout de SliderRangeTolerance pour le calcul de la plage du curseur, car les arrondis à virgule flottante peuvent être inexacts. (Ic918a, b/324934900).
• Assurez-vous que DatePickerDialog affiche ses boutons lors de l'imbrication d'une DateRangePicker ou lors de l'affichage de n'importe quel type de sélecteur de date sur les petits écrans avec des polices plus grandes. (Ie4758, b/325107799, b/277768544).
• Menu exploite désormais le rôle SurfaceContainer pour la couleur du conteneur. MenuDefaults.TonalElevation est désormais 0.dp. (I135b7).
• TextField exploite désormais le rôle SurfaceContainerHighest pour la couleur du conteneur. (I4dced).
• Les chips élevés exploitent désormais le rôle SurfaceContainerLow. (I7cd2f)
• La couleur du conteneur DatePicker est désormais SurfaceContainerHigh. DatePickerDefaults.TonalElevation est désormais 0.dp. (Ida753).
• Met à jour la couleur du conteneur des feuilles de bas de page et la couleur des poignées de déplacement. (I72a0a).
• La couleur du conteneur RichTooltip est désormais SurfaceContainer. (Ia8b45).
• La couleur du conteneur SearchBar est désormais SurfaceContainerHighest. SearchBarDefaults.TonalElevation est désormais 0.dp. (I88604).
• Bouton des mises à jour désactivé et des pistes/icônes non sélectionnées pour utiliser le rôle de couleur SurfaceContainerHighest. (I7687a).
• La couleur du conteneur AlertDialog est désormais SurfaceContainerHigh. (Ie0433).
• La couleur du conteneur BottomAppBar est désormais SurfaceContainer. La couleur de TopAppBar onScroll est désormais SurfaceContainer. (I41630).
• La couleur du conteneur ElevatedCard est désormais SurfaceContainerLow. Couleur du conteneur de FilledCard pour SurfaceContainerHighest. (I35141).
• La couleur du conteneur ElevatedButton est désormais SurfaceContainerLow. Lorsque l'option n'est pas sélectionnée, FilledIconButton est désormais associé à la couleur de conteneur SurfaceContainerHighest. (I792c9).
• Mise à jour de la couleur du conteneur TimePicker et du rôle de la couleur du cadran de l'horloge sur SurfaceContainerHighest. (I43b93).

Version 1.3.0-alpha01

21 février 2024

Publication d'androidx.compose.material3:material3-*:1.3.0-alpha01. Liste des commits de la version 1.3.0-alpha01

Nouvelles fonctionnalités

• Mise à jour des ModalBottomSheet Compose M3 pour prendre en charge la prévisualisation du Retour sur U+. (Iccf32, b/281967264, b/304850357)
• Mise à jour de Compose M3 SearchBar pour prendre en charge la prévisualisation du Retour sur U+. (I657f8)
• Mise à jour du curseur pour améliorer l'accessibilité grâce à l'ajout d'indicateurs d'intervalle et d'arrêt. (I3058e).
• Mise à jour de ProgressIndicator pour améliorer l'accessibilité en ajoutant un indicateur d'intervalle et d'arrêt. (I21451).
• Ajout d'un curseur de saisie par défaut pour une info-bulle enrichie, la nouvelle API d'info-bulle enrichie permet désormais de dessiner un curseur de saisie personnalisé à partir de l'ancre LayoutCoordinates. (Ifd42c).

Nouveaux comportements

• Les composants Material ont été migrés pour utiliser les nouvelles API d'ondulation et n'interrogent plus RippleTheme.

Modifications apportées à l'API

• L'élément drawStopIndicator amusant est désormais public. (I3f59f).
• Marquer la fonction formatWithSkeleton de DatePicker comme interne. (Ic65dc)
• DropdownMenu prend désormais en charge la couleur, la forme, l'élévation et la bordure personnalisées. (I8e981, b/289554448, b/301887035, b/283654243)
• Les composants Material3 qui exposent un MutableInteractionSource dans leur API ont été mis à jour pour exposer désormais un MutableInteractionSource pouvant avoir une valeur nulle qui est défini par défaut sur null. Il n'y a aucun changement sémantique ici: transmettre la valeur "null" signifie que vous ne souhaitez pas hisser MutableInteractionSource, qui sera créé dans le composant si nécessaire. Si vous passez à une valeur nulle, certains composants ne peuvent jamais allouer de MutableInteractionSource, et les autres composants ne peuvent créer une instance que de manière différée lorsqu'ils en ont besoin, ce qui améliore les performances de ces composants. Si vous n'utilisez pas le MutableInteractionSource que vous transmettez à ces composants, nous vous recommandons de transmettre la valeur "null". Nous vous recommandons également d'apporter les mêmes modifications à vos propres composants. (I41abb, b/298048146).
• Ajout de RippleConfiguration et LocalRippleConfiguration pour permettre la personnalisation des ondulations par composant / sous-arborescence à l'aide de valeurs fixes. Par exemple, pour modifier la couleur d'un composant que vous ne contrôlez pas ou pour désactiver une ondulation pour un composant. Dans la plupart des cas, les valeurs par défaut doivent être utilisées: ces API constituent une porte de secours pour la personnalisation de composants individuels / d'un nombre limité de sous-arborescences. Pour les modifications plus importantes et les systèmes de conception personnalisés, vous devez plutôt créer votre propre ondulation à l'aide de createRippleModifierNode. (I7b5d6, b/298048146).
• Ajout d'une nouvelle API d'ondulation dans Material3, qui remplace le rememberRipple obsolète. Ajout d'un CompositionLocal temporaire, LocalUseFallbackRippleImplementation, pour rétablir les composants Material3 afin qu'ils utilisent les API rememberRipple / RippleTheme obsolètes. Elle sera supprimée dans la prochaine version stable. Elle n'est destinée qu'à une aide temporaire à la migration lorsque vous fournissez un RippleTheme personnalisé. (I34cbc, b/298048146).

Correction de bugs

• Suppression de la sous-composition dans ModalBottomSheet pour améliorer les performances. Correction d'un problème qui provoquait le plantage de ModalBottomSheet dans des scénarios spécifiques en combinaison avec LookaheadScope. (I2a198).
• Suppression de la sous-composition dans BottomSheetScaffold pour améliorer les performances. Correction d'un problème qui provoquait le plantage de BottomSheetScaffold dans des scénarios spécifiques en combinaison avec LookaheadScope. (Ie6401).
• L'alignement du badge est ajusté pour être plus proche du centre du contenu d'ancrage par rapport à l'angle supérieur droit. (I18a28).
• Correction d'un problème d'accessibilité lié à DateRangePicker pour lequel le titre du mois (mois/année) était présenté comme exploitable pour les utilisateurs du lecteur d'écran, de Switch Access et de Voice Access. (I2ac55).
• Correction du bug lié à l'ordre des paramètres mediumTopAppBarColors. (Ibe64a).

Version 1.2

Version 1.2.1

6 mars 2024

Publication d'androidx.compose.material3:material3-*:1.2.1. La version 1.2.1 contient ces commits.

Correction de bugs

• Remettez en place la stabilité des états des curseurs. Redéfinir la valeur de State.onValueChangeFinished. Encapsuler onValueChangeFinished dans un rememberUpdatedState. (Ie8fd0, b/322269951).
• Suppression de @Stable des états de Slider, car nous avons remplacé state.onValueChangeFinished par var. (I82ba1, b/322269951).
• Correction de NavigationBar couleurs personnalisées pour copier les couleurs par défaut. (80a779, b/326894020).
• Correction de la régression dans ExposedDropdownMenu pour le rendre à nouveau sélectionnable. (3fcec1, b/323694447)
• Correction du problème de mise en cache des couleurs du bouton. (3e5bbcb/327371655)

Version 1.2.0

7 février 2024

Publication d'androidx.compose.material3:material3-*:1.2.0. Liste des commits de la version 1.2.0

Problème connu

• Un bug de rendu de l'interopérabilité View-Compose a été introduit dans PrimaryTabRow dans le cadre d'une modification de l'amélioration des performances. La solution consiste à utiliser TabRow avec TabRowDefaults.PrimaryIndicator.

Changements importants depuis la version 1.1.0

Nouveaux composants Material Design 3

• Tirer pour actualiser <ph type="x-smartling-placeholder">
  </ph>
  • Conteneur PullToRefresh
  • PullToRefreshState
• Bouton segmenté <ph type="x-smartling-placeholder">
  </ph>
  • Bouton segmenté
  • SingleChoiceSegmentedButtonRow
  • MultiChoiceSegmentedButtonRow

Améliorations apportées aux composants Material Design 3 existants.

• Barre d'application inférieure (alignement DAR, masquage automatique lors du défilement) <ph type="x-smartling-placeholder">
  </ph>
  • BottomAppBarScrollBehavior
• Modification visuelle des onglets <ph type="x-smartling-placeholder">
  </ph>
  • PrimaryIndicator
  • AdditionalIndicator (Indicateur secondaire).
• Badge (mise à jour de l'alignement)

API expérimentales rendues stables.

Amélioration des performances

• Pour en savoir plus, consultez cet article de blog.

Version 1.2.0-rc01

24 janvier 2024

Publication d'androidx.compose.material3:material3-*:1.2.0-rc01. Liste des commits de la version 1.2.0-rc01

Correction de bugs

• Correction du bug lié à l'ordre des paramètres mediumTopAppBarColors. (Ibe64a).
• Correction d'un bug introduit dans 1.2.0-beta02 dans CardDefaults.cardColors qui ne mettait pas à jour contentColor en fonction de la valeur du paramètre containerColor. (Iee041, b/319671246).
• Correction d'un bug dans disabledContentColor introduit dans 1.2.0-beta02 et ajout d'une petite optimisation. (I6dda1, b/318428829).

Version 1.2.0-beta02

10 janvier 2024

Publication d'androidx.compose.material3:material3-*:1.2.0-beta02. Liste des commits de la version 1.2.0-beta02

Bug connu

• Un bug dans IconButtonColors attribuera par défaut disabledContentColor à une version alpha (0,38f) de LocalContentColor au lieu de la contentColor spécifiée par l'utilisateur. La solution consiste à définir explicitement disabledContentColor. Ce problème sera résolu dans la prochaine version.

Modifications apportées à l'API

• Ajout de la possibilité d'activer les commandes d'info-bulle pour les API Tooltip de base. (Ibf767).
• SwipeToDismissState, rememberSwipeToDismiss et SwipeToDismissValue sont tous renommés _SwipeToDismissBox_. (I68d6d).

Correction de bugs

• Correction de la valeur de marge intérieure de fin de ListItem pour s'aligner sur les spécifications. (Ibd68b, b/305342674).
• La couleur du contour de la carte avec contours est désormais correctement mappée sur OutlineVariant. (I75480, b/310979715).
• La couleur dynamique est désormais extraite des rôles de couleur définis par le système. Cela améliore le contraste du contenu accessible et aligne plus précisément la couleur dynamique sur les spécifications de Material. (I1de96).
• Correction de la gestion des retours ModalBottomSheet sur Android T/13 et versions ultérieures lorsque android:enableOnBackInvokedCallback="true". (I728dc, b/306196110).

Version 1.2.0-beta01

13 décembre 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-beta01. Liste des commits de la version 1.2.0-beta01

Modifications apportées à l'API

• Marquer TabIndicatorScope comme expérimental (I45c88).
• Suppression des API expérimentales obsolètes pour l'info-bulle. (I438cb).
• Modifiez les nouvelles surcharges TabRow pour ne pas utiliser de sous-compositions. Il en résulte une manière différente de créer les indicateurs TabRow avec des modificateurs personnalisés fournis. (Ife741).
• Abandon des API DismissDirection et DismissValue. Elles ont été fusionnées avec SwipeToDismissValue, dont les valeurs indiquent à la fois la position et la direction de SwipeToDismissBox. DismissState.progress est désormais marqué comme FloatRange entre 0.0 et 1.0. Suppression de DismissState Saver et Constructor, devenus obsolètes. Le composant, l'état et l'objet par défaut de SwipeToDismiss ont été marqués comme expérimental. (Ib54f2).

Correction de bugs

• L'indicateur par défaut pour PullToRefresh est désormais une pointe de flèche ouverte au lieu d'un triangle plein. (I67be3).

Version 1.2.0-alpha12

29 novembre 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha12. Liste des commits de la version 1.2.0-alpha12

Modifications apportées à l'API

• RangeSlider accepte désormais une plage Kotlin (par exemple, 0f..1f) au lieu d'une classe de valeur FloatRange personnalisée. Désormais, SnapFlingBehavior.kt utilise également une plage Kotlin. (I025cb).
• Marquez les fonctions de fabrique de modificateurs comme @Stable. (Ib109f).

Version 1.2.0-alpha11

15 novembre 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha11. Liste des commits de la version 1.2.0-alpha11

Nouvelles fonctionnalités

• Implémentation de PullToRefreshContainer et PullToRefreshState, qui fournissent ensemble une implémentation de type "pull to refresh" dans Material3. (I16456, b/261760718).

Modifications apportées à l'API

• Marquez les éléments SwipeToDismissBox DismissDirection et DismissValue comme expérimentaux. (I517b0).
• SwipeToDismiss a été renommé SwipeToDismissBox. Renommez background en backgroundContent et dismissContent en lambda content de fin. (I7f4d3).
• Rendez le constructeur de ChipElevation et SelectableChipElevation public. (Ie0c48, b/308432421).
• Ajout de ModalBottomSheetProperties... Déplacement de securePolicy vers ModalBottomSheetProperties... Ajout de isFocusable et shouldDismissOnBackPress à ModalBottomSheetProperties. Ces nouvelles valeurs booléennes aident à déterminer comment la bottom sheet modale doit gérer les événements IME. (Iea56f, b/278216859).
• Mise à jour des états RangeSlider et Slider pour supprimer initialOnValueChange, les préfixes initiaux et les kdocs appropriés. (I57d30).
• Abandon de la classe ChipBorder et des appels de fonction associés. Nous vous recommandons d'utiliser directement BorderStroke à la place. (I89cc2).
• Les API Foundation Info-bulle sont désormais @ExperimentalFoundationApi. (I30b0b).
• TabRow et ScrollableTabRow ne sont plus obsolètes. Les nouvelles variantes principales et secondaires sont marquées comme expérimentales. (I0def6).
• Les chips de filtre et d'entrée utilisent désormais directement BorderStroke. (I07a8d).
• SegmentedButton utilise désormais BorderStroke directement. (I89b9b).
• Remplacement du nom de la fonction générique AlertDialog par BasicAlertDialog et abandon de la fonction précédente. (Idbe52).
• Renommez les API SwipeToDismiss en SwipeDismiss et convertissez les nouvelles API SwipeDismiss en API stables. (I14cbe).
• Ajout de tonalElevation et shadowElevation aux API d'info-bulles. De plus, nous avons replacé les API TooltipBox, PlainTooltip et RichTooltip au stade expérimental, car elles ont été publiées par erreur comme stables. (If0f66, b/293939035).
• Promotion des API de puce expérimentales en API stables. (Iea2c3).
• Suppression de l'annotation @ExperimentalMaterial3Api des cartes cliquables Material3. (I88dbf).

Correction de bugs

• Correction d'un problème qui provoquait le plantage de SwipeToDismiss dans certains scénarios avec des mises en page "Lookahead" et "Lazy" imbriquées. (Ica8d1, b/297226562).

Version 1.2.0-alpha10

18 octobre 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha10. Liste des commits de la version 1.2.0-alpha10

Modifications apportées à l'API

• Passage de Badge et BadgedBox en version stable. (I67f16, b/261565132).
• Ajout de securePolicy en tant que paramètre à ModalBottomSheet, afin que les utilisateurs puissent définir le comportement de WindowManager.LayoutParams.FLAG_SECURE. (Icdac8, b/296250262).
• Ajout de nouvelles surcharges de LinearProgressIndicator et CircularProgressIndicator qui acceptent progress comme lambda. Elles devraient être plus performantes que les versions précédentes. (I824e6, b/295616656).
• Renomme StandardSizeClasses en AllSizeClasses. (I8cb07).
• Combiner les fonctions de calcul des classes de taille de fenêtre. (Iad935).

Correction de bugs

• Correction d'un plantage de DatePicker lors d'un clic rapide sur les flèches de navigation lorsque le mois affiché était proche de la plage d'années autorisée. (I46f36, b/290954897, b/297002119).
• [Nav rail/bar] Prise en charge d'une couleur transparente pour l'indicateur. (Ie0a9b, b/267289987).

Version 1.2.0-alpha09

4 octobre 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha09. Liste des commits de la version 1.2.0-alpha09

Modifications apportées à l'API

• Migration de ModalNavigationDrawer et DismissibleNavigationDrawer pour utiliser les nouvelles API AnchoredDraggable. Le animateTo de DrawerState a été remplacé par les méthodes d'ouverture et de fermeture, et le décalage est désormais exposé en tant que float au lieu d'un objet d'état. Vous pouvez accéder au décalage directement via currentOffset. (I0a72c).
• Des fonctions non composables ont été ajoutées pour créer directement un DatePickerState et un DateRangePickerState. Ces fonctions peuvent être utilisées comme alternative aux fonctions composables rememberDatePickerState et rememberDateRangePickerState si nécessaire. (I70326, b/291524052).
• Les TabRows fixes et déroulantes comportent désormais des variantes principales et secondaires. Ceux-ci sont correctement mappés avec le comportement des couleurs et des indicateurs tel que défini dans Material3.
• PrimaryScrollableTabRow et SecondaryScrollableTabRow exposent désormais l'état de défilement. (Iec8f5, b/260572337).
• Ajout d'un nouveau paramètre sheetMaxWidth que les développeurs peuvent définir pour spécifier la largeur maximale de la feuille. Dp.Unspecified peut être transmis pour le paramètre si vous souhaitez utiliser une feuille qui s'étend sur toute la largeur de l'écran. (Ifb7c9, b/266697696).
• Ajout des API PlainTooltipBox et RichTooltipBox en tant que méthodes obsolètes. (I246fa).

Correction de bugs

• Correction d'un plantage lorsque DatePicker est initialisé avec un DatePickerFormatter dont les squelettes de dates restent identiques lorsqu'ils sont convertis en modèles de date (par exemple, AA). (I01f29).

Version 1.2.0-alpha08

20 septembre 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha08. Liste des commits de la version 1.2.0-alpha08.

Modification destructive affectant le comportement

• ColorScheme est désormais immuable. Les mises à jour de couleurs individuelles sont donc moins efficaces, mais l'utilisation des couleurs plus courante devient plus efficace. Ce changement s'explique par le fait que la mise à jour des couleurs individuelles n'est pas le cas d'utilisation principal pour la majorité des applications. Cela est toujours possible, mais la recomposition sera plus importante qu'auparavant. Par conséquent, nous réduirons considérablement le nombre d'abonnements à des états via tout le code Material, ce qui aura un impact sur le coût d'initialisation et d'exécution pour les cas d'utilisation plus standards. (Ic447d, b/297212873).
• L'élévation tonale ne s'anime plus dans différents états d'interaction pour correspondre à la spécification. (Icdd12).

Modifications apportées à l'API

• Ajout d'un BottomAppBar qui utilise un BottomAppBarScrollBehavior comme paramètre afin de le masquer automatiquement lorsque l'utilisateur fait défiler le contenu. Ajout de FabPosition.EndOverlay permettant au bouton d'action flottant de superposer la barre d'application inférieure dans l'échafaudage au lieu d'être ancré au-dessus. (Iecb47).
• Ajout d'un composant de libellé simple qui s'appuie sur BasicTooltipBox et qui ne se ferme pas lorsque l'utilisateur appuie en dehors des limites du libellé. (I821f9).

Correction de bugs

• Suppression de l'utilisation de rememberSaveable pour les info-bulles. (Icc131, b/299500338).
• Introduction d'un indicateur temporaire pour contrôler si Scaffold doit mesurer ses enfants pendant la mesure ou le placement. Par défaut, ces données sont mesurées. Si vous rencontrez des problèmes avec le nouveau comportement, veuillez signaler un problème. (I0b354).
• Correction du bord horizontal à bord dans BottomSheet en utilisant la mesure correcte pour la largeur de l'écran de l'appareil. (I1df0c, b/299058752).
• Correction d'un bug qui empêchait ModalBottomSheet d'appeler onDismissedRequest lors de sa fermeture en balayant la feuille vers le bas. (Idfdd8).

Version 1.2.0-alpha07

6 septembre 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha07. Liste des commits de la version 1.2.0-alpha07

Nouvelles fonctionnalités

• La prise en charge des icônes de mise en miroir automatique a été ajoutée dans compose material 1.6.0-alpha05. Veuillez consulter les notes de version pour en savoir plus sur les icônes de mise en miroir automatique.

Modifications apportées à l'API

• SliderState implémente DraggableState. (I9b116)
• Transforme la forme en paramètre obligatoire. Changement de nom : position devient index dans la fonction d'assistance de forme. (I34941).
• Met à jour le formatWithSkeleton DatePicker pour inclure une carte qui servira de cache pour améliorer les performances. (I3195f).
• Ajout de BasicTooltipBox à compose.foundation, et mise à jour de PlainTooltipBox et RichTooltipBox pour utiliser TooltipBox avec les nouveaux composables PlainTooltip et RichTooltip. (I79e1d).

Correction de bugs

• dynamicLightColorScheme et dynamicDarkColorScheme renvoient désormais des couleurs de chrominance plus élevées pour les rôles de surface et surfaceContainer. (I5e901).
• Correction d'un problème où certains composants utilisant la sous-composition (par exemple, BottomSheetScaffold) dans un échafaudage dans un LookaheadScope tentaient de lire leur taille trop tôt. (I297b4, I871f1, b/295536718).

Version 1.2.0-alpha06

23 août 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha06. Liste des commits de la version 1.2.0-alpha06

Correction de bugs

• Correction du calcul offset de DropdownMenu afin que les décalages X dépendent uniquement de la direction de la mise en page locale. Les décalages Y ne sont plus inversés lorsque le menu se trouve en bas de l'écran. (Iccc74, b/294103942).
• Correction du calcul offset de DropdownMenu afin que les décalages X dépendent uniquement de la direction de la mise en page locale. Les décalages Y ne sont plus inversés lorsque le menu se trouve en bas de l'écran. (Ib87a2, b/294103942).

Version 1.2.0-alpha05

9 août 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha05. Liste des commits de la version 1.2.0-alpha05

Modifications apportées à l'API

• Mises à jour des couleurs de la case à cocher et de TriStateCheckbox. Le disabledUncheckedColor CheckboxDefaults.colors() n'affecte désormais que la bordure de la case à cocher. Dans les cas particuliers où vous devez définir la couleur de la zone interne lorsque celle-ci est désactivée ou décochée, vous devez créer une instance personnalisée d'un CheckboxColors avec les valeurs de couleur souhaitées. (I77d17, b/291943198).

Version 1.2.0-alpha04

26 juillet 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha04. Liste des commits de la version 1.2.0-alpha04

Nouvelles fonctionnalités

• API expérimentale Segmented Button (Ifc8fb)
• Les séparateurs disposent désormais d'un paramètre permettant de contrôler l'orientation pour prendre en charge les séparateurs verticaux. (I4c899, b/288438593).

Modifications apportées à l'API

• Nous déplaçons la dépendance de densité au niveau du composant. Cela s'applique aux composants suivants: SwipeToDismiss et aux composants basés sur une feuille de calcul Sheets. Veuillez utiliser la nouvelle surcharge fournie lorsque la densité est un paramètre. (I1846e).
• Annotations supplémentaires pour spécifier les entrées autorisées pour les composables. (Ief234)
• Ajoutez un paramètre d'icône au bouton segmenté et une sémantique de fractionnement afin que les boutons segmentés puissent être sélectionnés pour implémenter la sélection unique, et activables pour implémenter la sélection multiple, avec SelectableSegmentedButtonRow et ToggelableSegmentedButtonRow respectivement. (I38740).
• Le séparateur a été renommé HorizontalDivider. Ajout de la fonctionnalité VerticalDivider. (I5975c).
• Modification de l'utilisation de ClosedFloatingPointRange pour le FloatRange plus léger dans les API Material3 expérimentales afin de minimiser l'autoboxing. (I4aab5).
• Ajout d'un nouvel alignement Start pour FabPosition. (Ib7aea, b/170592777)

Correction de bugs

• ModalBottomSheet respecte la direction de la mise en page locale. (Ib4f44, b/285628622).

Version 1.2.0-alpha03

21 juin 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha03. Liste des commits de la version 1.2.0-alpha03

Nouveaux comportements

• includeFontPadding est désormais false par défaut dans la typographie Material 3. Le style de hauteur de ligne par défaut a également été remplacé par Trim.None et Alignment.Center, et des lineHeight explicites (dans les sp) ont été ajoutés aux TextStyle de Typography. Consultez la documentation de l'API si vous souhaitez personnaliser ces valeurs, ainsi que l'article de blog pour une explication détaillée de ces modifications. (I6266f, Icabc3).

Nouvelles fonctionnalités

• Ajout d'une surcharge pour RangeSlider, qui est une version avec état du composant. Création de RangeSliderState, qui contient toutes les informations du titre actif en cours, les mesures des composants de RangeSlider, ainsi que la logique de déplacement et de geste. (I8c270).
• La barre de recherche prend désormais en charge les ombres via le nouveau paramètre shadowElevation. (Ia5369, b/271040353).
• ColorScheme est désormais compatible avec les nouveaux rôles SurfaceContainer.
• La superposition d'élévation tonale de la surface peut désormais être désactivée avec la composition LocalTonalElevationEnabled locale. (Ic203c, b/277774590).

Modifications apportées à l'API

• Ouvrez les constructeurs de couleurs des composants. (I8c4a6).
• Ajout d'un paramètre sélectionnable aux deux API d'info-bulles, afin que les développeurs puissent autoriser ou non l'info-bulle à utiliser les événements tactiles. Soyez prudent, car cela peut interrompre le balayage automatique du curseur de l'accessibilité. (Ie32d8).
• Accessibilité optimisée pour les performances et l'allocation de mémoire (Iede48).
• Exposition de DefaultSizeClasses et création de StandardSizeClasses pour WindowSizeClasses. (I91838)
• Remplacement de WindowWidth/HeightSizeClass par des classes de valeurs flottantes. (Ie686e)

Correction de bugs

• Le paramètre contentWindowInsets de Scaffold respecte désormais les encarts de fenêtre consommés. Notez que le comportement de la marge intérieure du contenu basée sur topBar et bottomBar reste inchangé lorsque ces paramètres sont fournis. (I08b73, b/264601542).
• Corrigez l'alignement de la barre d'application supérieure centrale pour éviter qu'un titre long ne s'affiche par-dessus les icônes d'action ou l'icône de navigation. (I4369f, b/236994621).
• Les positions d'onglet appliquent désormais une largeur de contenu minimale de 24 dp. Vous disposez ainsi d'une zone cible tactile accessible pour les indicateurs d'onglet. (Id8861).
• Les palettes de couleurs dynamiques de dynamicLightColorScheme et dynamicDarkColorScheme sont désormais compatibles avec de nouveaux rôles de surface. (I1252e).
• Modification de l'alignement des notifications de badge pour qu'elles ne soient pas rognées en cas de collision avec l'arrière-grand-parent. (Idf75a).

Version 1.2.0-alpha02

24 mai 2023

Publication d'androidx.compose.material3:material3-*:1.2.0-alpha02. Liste des commits de la version 1.2.0-alpha02

Modifications apportées à l'API

• Ajout d'un paramètre d'encarts de fenêtre à ModalBottomSheet.
  • Le fond de ModalBottomSheet peut désormais être dessiné derrière la barre d'état avec windowInsets défini sur zéro
  • Mise à jour de la fonctionnalité ModalBottomSheet par défaut pour rester en dehors des barres système, y compris la navigation
  • La gestion des encarts de la barre d'état est assurée par la poignée de déplacement en mode bord à bord.
  • BottomSheetDefaults inclut des encarts de fenêtre pour BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/2754)
• Abandon de Indicator et ajout de Primary/SecondaryIndicator pour respecter les spécifications M3. PrimaryIndicator correspond à la largeur du contenu de l'onglet, tandis que SecondaryIndicator s'étend sur toute la largeur disponible. SecondaryIndicator équivaut à Indicator, désormais obsolète, et peut être un remplacement direct. (I27604).
• Ajout d'une option permettant de transmettre un ScrollState lors de la construction d'un DropdownMenu ou d'un ExposedDropdownMenu pour contrôler l'état de défilement vertical des éléments de menu affichés. (Ia0734, b/185304441).
• Ajout d'une surcharge pour Slider, qui est une version avec état du composant. Création de SliderState, qui contient toutes les informations du titre actif en cours, les mesures des composants de Slider, ainsi que la logique de déplacement et de geste. (I124a5).
• Remplacement du nom de la propriété sémantique isContainer par isTraversalGroup. (I121f6)
• Ajout d'une TextStyle.merge(...) optimisée avec la liste complète des paramètres. (Iad234, b/246961787).
• Interfaces publiques TooltipState, RichTooltipState et PlainTooltipState. Ajout de RichTooltipStateImpl et PlainTooltipStateImpl pour les états par défaut. Ajout de fonctions remember*State pour obtenir ces états implémentés. Suppression de TooltipSync au profit d'un TooltipDefault.GlobalMutatorMutex. (I7813d).
• Mise à jour de DatePickerColors pour inclure des options de personnalisation supplémentaires pour le séparateur du sélecteur de date, la navigation et les couleurs des champs de saisie de texte. (I1a685, b/274626815).
• DatePickerState et DateRangePickerState sont désormais des interfaces publiques avec des implémentations par défaut pouvant être récupérées par rememberDatePickerState et rememberDateRangePickerState. (I71c52).
• Suppression de dateValidator de DatePicker et DateRangePicker, et ajout d'une interface SelectableDates pouvant être définie sur l'état pour contrôler les dates ou les années sélectionnables dans l'UI. (Ic2fc6).
• Suppression de TimePicker de l'API stable. D'autres modifications sont attendues dans l'API State. (I3f39a)
• ModalBottomSheet migrée vers Android uniquement. ModalBottomSheet n'est pas recommandé pour une utilisation sur ordinateur, et cette fonctionnalité n'est pas activement maintenue. (Ib3778).

Correction de bugs

• Correction de l'action "Ignorer" AlertDialog qui s'affichait sous l'action de confirmation lorsque les actions étaient empilées les unes sur les autres pour s'adapter à la largeur de la boîte de dialogue. Ce correctif aligne l'implémentation sur la spécification Material Design. (I029de, b/235454277).
• Correction d'un bug dans ListItem qui utilisait une marge intérieure incorrecte pour les éléments de trois lignes. (I6e235).
• ModalBottomSheet peut désormais afficher le clavier IME. (Idc508, b/262140644, b/268380384, b/272483584)

Version 1.2.0-alpha01

10 mai 2023

Publication d'androidx.compose.material3:material3:1.2.0-alpha01 et d'androidx.compose.material3:material3-window-size-class:1.2.0-alpha01. Liste des commits de la version 1.2.0-alpha01

Version 1.1

Version 1.1.2

20 septembre 2023

Publication d'androidx.compose.material3:material3:1.1.2 et d'androidx.compose.material3:material3-window-size-class:1.1.2. Liste des commits de la version 1.1.2

Correction de bugs

• Correction du modificateur qui était transmis de manière incorrecte à deux composables. (b/282761472).
• Correction de TimePickerState qui renvoyait des heures incorrectes lorsqu'il était initialisé avec 23 heures. (b/278242122).
• Correction de l'état d'activation initial pour la validation de midi et des minutes. (b/269768197, b/282790635).
• Correction de state.hour renvoyant une valeur incorrecte pour 23h. (b/282761472, b/278242122).

Version 1.1.1

21 juin 2023

Publication d'androidx.compose.material3:material3:1.1.1 et d'androidx.compose.material3:material3-window-size-class:1.1.1. Liste des commits de la version 1.1.1

Correction de bugs

• Ajout d'un appel pour ModalBottomSheet sans paramètre windowInset pour la compatibilité binaire. (Ib7959).
• Ajout d'un paramètre d'encarts de fenêtre à ModalBottomSheet.
  • Le fond de ModalBottomSheet peut désormais être dessiné derrière la barre d'état avec windowInsets défini sur zéro
  • Mise à jour de la fonctionnalité ModalBottomSheet par défaut pour rester en dehors des barres système, y compris la navigation
  • La gestion des encarts de la barre d'état est assurée par la poignée de déplacement en mode bord à bord.
  • BottomSheetDefaults inclut des encarts de fenêtre pour BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/2754)

Version 1.1.0

10 mai 2023

Publication d'androidx.compose.material3:material3:1.1.0 et d'androidx.compose.material3:material3-window-size-class:1.1.0. Liste des commits de la version 1.1.0

Principales fonctionnalités de la version 1.1.0

Nouveaux composants Material Design 3

• Bottom sheets <ph type="x-smartling-placeholder">
  </ph>
  • ModalBottomSheet, BottomSheetScaffold
• Sélecteurs de date <ph type="x-smartling-placeholder">
  </ph>
  • DatePicker, DateRangePicker, DatePickerDialog
• Réseau de Recherche <ph type="x-smartling-placeholder">
  </ph>
  • SearchBar et DockedSearchBar
• Balayer pour ignorer
• Sélecteurs d'heure <ph type="x-smartling-placeholder">
  </ph>
  • Sélecteur de temps
  • TimeInput
• Info-bulles <ph type="x-smartling-placeholder">
  </ph>
  • PlainTooltipBox, RichTooltip

Améliorations apportées aux composants Material Design 3 existants.

API expérimentales rendues stables.

Pour en savoir plus, consultez cet article de blog.

Version 1.1.0-rc01

19 avril 2023

Publication d'androidx.compose.material3:material3:1.1.0-rc01 et d'androidx.compose.material3:material3-window-size-class:1.1.0-rc01. Liste des commits de la version 1.1.0-rc01

Modifications apportées à l'API

• Suppression de TimePicker de l'API stable. D'autres modifications sont attendues dans l'API State. (I3f39a)
• ModalBottomSheet migrée vers Android uniquement. ModalBottomSheet n'est pas recommandé pour une utilisation sur ordinateur, et cette fonctionnalité n'est pas activement maintenue. (Ib3778).

Version 1.1.0-beta02

5 avril 2023

Publication d'androidx.compose.material3:material3:1.1.0-beta02 et d'androidx.compose.material3:material3-window-size-class:1.1.0-beta02. Liste des commits de la version 1.1.0-beta02

Modifications apportées à l'API

• SheetState dispose désormais du paramètre skipHiddenState facultatif
• rememberStandardBottomSheetState dispose désormais du paramètre skipHiddenState facultatif
• BottomSheetScaffold dispose désormais d'une ancre cachée définie, bien qu'elle soit désactivée par défaut
• La documentation SheetState.requireOffset a été mise à jour
• Changement de nom : BottomSheetDefaults.MinimizedShape devient BottomSheetDefaults.HiddenShape. (I839f4, b/273870234)

Correction de bugs

• Ne changez pas le cadran d'une heure à une autre lorsque l'exploration tactile est activée. (I717d0).
• La sémantique des poignées de déplacement ModalBottomSheet et BottomSheetScaffold sont désormais fusionnées. (I05afb).
• Le modificateur BottomSheetScaffold, et les paramètres containerColor et contentColor n'affectent désormais que le contenu. (I992cb).
• BottomSheetScaffold nestedScroll pour le contenu de la feuille implémente désormais les glissements d'un geste vif. (I992cb).

Version 1.1.0-beta01

22 mars 2023

Publication d'androidx.compose.material3:material3:1.1.0-beta01 et d'androidx.compose.material3:material3-window-size-class:1.1.0-beta01. Liste des commits de la version 1.1.0-beta01

Modifications apportées à l'API

• Ajout d'un paramètre de type de mise en page au composable TimePicker. Elle permet d'utiliser différentes mises en page en fonction de la configuration de l'écran. (Ia0e16)
• SearchBarDefaults a été marqué comme expérimental. (I65561).
• Ajout d'une élévation des ombres à BottomSheetScaffold. (I94e0f)
• Ajout de la possibilité d'afficher les sélecteurs de date sans la partie d'en-tête. Modifications apportées à l'API pour permettre la transmission d'un titre nul lors de la création d'un sélecteur de date. Vous pouvez maintenant transmettre des titres, des titres et des showToggleMode = false nuls pour afficher un sélecteur sans interface graphique. (Id3f3a, b/266132421, b/267194809).

Correction de bugs

• Les barres de recherche désactivent désormais automatiquement le curseur lorsqu'elles sont désactivées. (I22a7c, b/261444487).
• Modification du DateRangePicker pour permettre de sélectionner une plage dont le début et la fin sont identiques. (I16529, b/272882497).
• Les champs de texte positionnent désormais correctement leurs éléments de texte lorsque la taille de la police est plus petite que prévu. Cela peut entraîner une modification de quelques pixels dans vos applications, en fonction des paramètres de police et du script. (I8b8d0).
• Les actions sémantiques de la bottom sheet comportent désormais des étiquettes. (I277b0).

Version 1.1.0-alpha08

8 mars 2023

Publication d'androidx.compose.material3:material3:1.1.0-alpha08 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha08. Liste des commits de la version 1.1.0-alpha08

Nouvelles fonctionnalités

• Ajout de la prise en charge de BottomSheetScaffold et BottomSheetScaffoldState. (I063d4).

Modifications apportées à l'API

• Ajout de fonctionnalités à DatePickerState et DateRangePickerState pour permettre de définir des dates après la création initiale de l'état, ainsi que de réinitialiser les sélections en définissant des horodatages nuls. Vous devez faire preuve de prudence lorsque vous définissez des dates manuellement. La nouvelle fonction setSelection génère une exception si une date fournie échoue à une condition préalable (voir la documentation). (Ifa645, b/268609314, b/270427389).
• Remplacement du nom SheetValue réduit par PartiallyExpanded pour une représentation plus précise et flexible du comportement dans cet état. (Ia1491).
• Remplacement du nom des paramètres ListItem par _content au lieu de _text. Les getters par défaut sont désormais ReadOnlyComposables le cas échéant. (I69a25).
• Mise à niveau des API Surface interactives à partir des API expérimentales. (I90d59, b/261561812).

Correction de bugs

• Correction d'un problème qui entraînait un calcul incorrect de l'état HalfExpanded de ModalBottomSheet et la feuille semblait flottante. (I45e84, b/268411386).
• Ajout de la coche confirmValueChange pour appuyer sur le fond pour ModalBottomSheet. (I2311a, b/270425759).
• Déplacement des actions sémantiques BottomSheet vers la poignée de déplacement. (I158ba).
• Les commandes ModalBottomSheet se concentrent désormais sur le lancement et gère le bouton "Retour". (I4d2ab).
• Désormais, ModalBottomSheet onDismissRequest est également géré lors des glissements de défilement imbriqués. (I655c5, b/268433166).

Version 1.1.0-alpha07

22 février 2023

Publication d'androidx.compose.material3:material3:1.1.0-alpha07 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha07. Liste des commits de la version 1.1.0-alpha07

Nouvelles fonctionnalités

• Ajout d'un composable "Time Input" qui fonctionne avec rememberTimePickerState(). Il respecte la spécification M3 concernant la saisie de l'heure. (Ia4fab)
• Ajout d'une API DateRangePicker Material 3 pour sélectionner une plage de dates. (I7a6c3, b/267194809).
• Ajout d'une prise en charge du mode de saisie Material 3 pour la sélection de plages de dates via l'API DateRangePicker. (Ifdbc4).
• Vous pouvez désormais personnaliser les couleurs des champs de texte: <ph type="x-smartling-placeholder">
  </ph>
  • Couleurs du texte du champ de saisie et des espaces réservés en fonction du focus et de l'état d'erreur. Le paramètre textColor a été renommé unfocusedTextColor, et placeholderColor a été renommé unfocusedPlaceholderColor.
  • Couleur du conteneur pour les champs de texte remplis en fonction de l'état d'erreur avec le nouveau paramètre errorContainerColor.
• Les couleurs des champs de texte du menu déroulant exposés ont été mises à jour avec des paramètres compatibles avec la nouvelle API de préfixe et de suffixe. (I9c8b4, b/254284181, b/264766350).

Modifications apportées à l'API

• Rétablissement de certaines versions de l'API Curseur et suppression des surcharges redondantes couvertes par la nouvelle version expérimentale de curseur avec curseur et piste personnalisés. Promotion de la version stable de RangeSlider. (Ie8fbd).
• Remplacement du nom de defaultElevation par elevation dans les fonctions d'élévation du chip. (I0f872).
• Les API de champs de texte Material 3 suivantes ne sont plus expérimentales: TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding et outlinedTextFieldPadding. (Ieb5c0, b/261561819).
• TimePickers is24Hour utilise les paramètres système. (I18856)
• Suppression de l'annotation expérimentale des API scaffold. (Ibb51e, b/261565765, b/261436953).

Correction de bugs

• La forme par défaut de ModalBottomSheet est désormais toujours SheetDefaults.ExpandedShape. (I0dfca).
• Améliorations de l'accessibilité pour DatePicker et DateRangePicker Material 3. (I5087e).
• Correction d'un bug qui provoquait la propagation de la contrainte de hauteur maximale et pouvait planter. (I30d8c).
• Suppression des rôles sémantiques des surfaces cliquables et sélectionnables, et mise à jour des composants qui les utilisaient pour définir des rôles à l'aide de modificateur.semantics. (I793d9)

Version 1.1.0-alpha06

8 février 2023

Publication d'androidx.compose.material3:material3:1.1.0-alpha06 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha06. Liste des commits de la version 1.1.0-alpha06

Nouvelles fonctionnalités

• Les champs de texte sont désormais compatibles avec le texte du préfixe et du suffixe. (Ia8578, b/179884561)
• Ajout d'une fonction TimePicker pour afficher un outil de sélection de l'heure conformément à la spécification Material 3, utilisée avec TimePickerState et la méthode pratique rememberTimePickerState. (I71910)
• Une date saisie est désormais un mode d'affichage dans DatePicker. Il est maintenant possible de passer du sélecteur de date au mode de saisie de date, et vice versa. (Ieeff7)
• API ajoutée pour RichTextTooltips. (I58ef3)
• Implémentation de la bottom sheet modale pour Material 3, y compris ModalBottomSheet et ModalBottomSheetDefaults. Ajout également de SheetState et de rememberSheetState, qui peuvent être utilisés pour les futurs composants de la feuille. (I0853a, b/244189383)

Modifications apportées à l'API

• Stabilisation de l'API showSnackbar. (I195c2, b/261424370)
• Stabilisation des API pour le chip d'assistance et le chip de suggestion. (Ibb67b, b/261424370)
• Passage de l'API ListItem, ListItemDefaults et ListItemColors en version non expérimentale. (I7e7fa, b/261438882)
• Passage de SliderPositions, SliderDefaults.Thumb et SliderDefaults.Track en version stable, et ajout d'API Slider et RangeSlider non expérimentales contenant des pouces et des canaux personnalisés. Abandon des API Slider et RangeSlider précédentes. (Ie5ea6, b/261566890)
• Modifier.tooltipAnchor() est désormais public, afin que les développeurs puissent le transmettre à l'ancre pour indiquer qu'une info-bulle doit s'afficher lorsque l'utilisateur appuie de manière prolongée. L'API PlainTooltipBox a été mise à jour pour ne plus permettre à TooltipState d'avoir une valeur nulle. Dispose désormais d'une valeur par défaut. (Ie2fb7)
• ProgressIndicatorDefaults.circularTrackColor a été marqué @Composable à des fins de cohérence. (Id29cc)
• Le getter LocalMinimuTouchTargetEnforcement a été restauré, marqué comme obsolète, puis redirigé vers LocalMinimumInteractiveComponentEnforcement. (I60dd5)

Version 1.1.0-alpha05

26 janvier 2023

Publication d'androidx.compose.material3:material3:1.1.0-alpha05 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha05. Liste des commits de la version 1.1.0-alpha05

Nouvelles fonctionnalités

• DatePickerDialog et accessibilité
• Pouce et piste personnalisés ajoutés à RangeSlider.

Mises à jour des dépendances

• Compose UI et Compose Material dépendent désormais de Lifecycle 2.6.0.

Version 1.1.0-alpha04

11 janvier 2023

Publication d'androidx.compose.material3:material3:1.1.0-alpha04 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha04. Liste des commits de la version 1.1.0-alpha04

Nouvelles fonctionnalités

• API DatePicker initiale permettant de choisir une date via une UI d'agenda. Cette API est toujours en cours de modification. (I722b9)
• Ajout de la prise en charge des info-bulles en texte brut via PlainTooltipBox. (I0cdfb)
• Barre de recherche (Iad128)
• SwipeToDismiss (I458a8, b/242889540)

Modifications apportées à l'API

• Ajout à la propriété sémantique IsContainer sur les surfaces. Cette propriété sera utilisée lors d'une modification ultérieure qui détermine l'ordre de navigation en fonction de la signification sémantique des éléments tels que les surfaces. (I63379)
• Marquage des API associées au panneau de navigation comme stables. (Iab01e, b/261439597)
• Ajout d'un paramètre de couleur de suivi pour les indicateurs de progression circulaires, et d'un paramètre de limite de trait pour les indicateurs de progression circulaires et linéaires. (Ie668c, b/216325962, b/222964817)
• Possibilité de valeur nulle de type renvoyé accrue pour les fonctions obsolètes ou masquées. (Ibf7b0)
• Ajout de Modifier.minimumInteractiveComponentSize. Vous pouvez l'utiliser pour réserver une taille d'au moins 48 dp pour résoudre les problèmes d'interaction tactile si l'élément est plus petit. (I33f58, b/258495559)
• Ajout d'une API expérimentale pour le composable AlertDialog comportant un emplacement de contenu. (Iec4a2)

Correction de bugs

• La progression des indicateurs de progression est désormais correctement limitée à la plage attendue. (I8a7eb, b/262262727)

Problème connu

• Lorsque vous passez de androidx.compose.foundation:1.4.0-alpha03 à androidx.compose.foundation:1.4.0-alpha04, une erreur java.lang.NoSuchFieldError peut se produire. Le problème a été initialement signalé ici. Un correctif a été envoyé et sera disponible lors de la prochaine mise à jour de Compose. Pour contourner ce problème, mettez à jour votre androidx.compose.material et androidx.compose.material3 vers la dernière version (1.1.0-alpha04) ou revenez à la version 1.4.0-alpha03 de androidx.compose.foundation.

Version 1.1.0-alpha03

7 décembre 2022

Publication d'androidx.compose.material3:material3:1.1.0-alpha03 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha03. Liste des commits de la version 1.1.0-alpha03

Modifications apportées à l'API

• consumedWindowInsets() a été renommé consumeWindowInsets(), et withConsumedWindowInsets() onConsumedWindowInsetsChanged(), et les modificateurs sont désormais publics. (Ie44e1)
• Ajout d'une marge intérieure par défaut pour le bouton de texte avec icône à utiliser. (I8f662)
• Ajout de couleurs désactivées pour la barre de navigation et le rail. (Ia7892, b/258867034)
• Ajout d'une API de modificateur pour interroger les informations de défilement des ancêtres. (I2ba9d, b/203141462)
• Utilisation dans Clickable pour retarder correctement les interactions liées à une pression du doigt susceptible de devenir un événement de défilement.
• Correction de Clickables qui ne retardait pas correctement les ondulations en cas d'utilisation dans un Scrollable ViewGroup.
• Mise à jour des panneaux et des feuilles pour retarder les pressions du doigt lorsque les gestes peuvent devenir des événements de défilement.

Mises à jour des dépendances

• Compose UI et Compose Material dépendent désormais de Lifecycle version 2.5.1. (I05ab0, b/258038814)

Version 1.1.0-alpha02

9 novembre 2022

Publication d'androidx.compose.material3:material3:1.1.0-alpha02 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha02. Liste des commits de la version 1.1.0-alpha02

Modifications apportées à l'API

• awaitFirstDown et waitForUpOrCancellation acceptent désormais PointerEventPass pour plus de flexibilité (et correction de ExposedDropdownMenuBox qui affichait un menu lorsque l'utilisateur faisait défiler la page). (I7579a, b/212091796)
• Ajout du paramètre minLines dans le texte Material et Material3, ainsi que TextField et OutlinedTextField, ce qui permet de définir la hauteur minimale du composant en termes de nombre de lignes. (I4af1d)
• Abandon de la fonction TopAppBarDefaults smallTopAppBarColors au profit d'une nouvelle fonction topAppBarColors à utiliser lors de la création d'une TopAppBar. (Ie6cb9)
• Ajout du paramètre minLines dans BasicText et BasicTextField. Permet de définir la hauteur minimale de ces composables en nombre de lignes. (I24294, b/122476634)

Correction de bugs

• Création d'un extrait à partir du contenu des IconButton et IconToggleBotton Material3 à la forme de la couche d'état du composant (par exemple, forme circulaire). (I9da8f)
• Mise à jour des barres d'application supérieures Material3 grandes et moyennes afin d'appliquer la même couleur d'arrière-plan à toute la surface et de pouvoir remplacer les couleurs par défaut par des valeurs de couleur transparentes. (I67659, b/249688556, b/250838918)

Version 1.1.0-alpha01

24 octobre 2022

Publication d'androidx.compose.material3:material3:1.1.0-alpha01 et d'androidx.compose.material3:material3-window-size-class:1.1.0-alpha01. Liste des commits de la version 1.1.0-alpha01

Correction de bugs

• Corrections apportées à la barre d'application supérieure lorsque le titre est appliqué avec un style de texte et un pinceau. (If667e)

Version 1.0

Version 1.0.1

9 novembre 2022

Publication d'androidx.compose.material3:material3:1.0.1 et d'androidx.compose.material3:material3-window-size-class:1.0.1. Liste des commits de la version 1.0.1

Correction de bugs

• Mise à jour des barres d'application supérieures Material3 grandes et moyennes afin d'appliquer la même couleur d'arrière-plan à toute la surface et de pouvoir remplacer les couleurs par défaut par des valeurs de couleur transparentes. (I67659, b/249688556, b/250838918)

Version 1.0.0

24 octobre 2022

Publication d'androidx.compose.material3:material3:1.0.0 et d'androidx.compose.material3:material3-window-size-class:1.0.0. Liste des commits de la version 1.0.0

Principales fonctionnalités de la version 1.0.0

Première version stable de Compose Material 3.

Thématisation Material Design 3 et couleur dynamique Material You

• MaterialTheme
• Couleur
  • ColorScheme
  • lightColorScheme, darkColorScheme
• Couleur dynamique
  • dynamicLightColorScheme, dynamicDarkColorScheme
• Typographie
  • Typographie
• Formes
  • Formes

Composants Material Design 3

• Badge
  • Badge, BadgedBox
• Barre d'application inférieure
  • BottomAppBar
• Boutons
  • Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
• Bouton d'action flottant et bouton d'action flottant étendu
  • SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
• Fiches
  • Card, OutlinedCard, ElevatedCard
• Case à cocher
  • Case à cocher
• Chips
  • AssistChip, ElevatedAssistChip, FilterChip, ElevatedFilterChip, InputChip, SuggestionChip, ElevatedSuggestionChip
• Boîtes de dialogue
  • AlertDialog
• Séparateur
  • Séparateur
• Menu déroulant
  • DropdownMenu, DropdownMenuItem, ExposedDropdownMenuBox
• Liste
  • ListItem
• Barre de navigation
  • NavigationBar
• Panneau de navigation
  • ModalNavigationDrawer, ModalDrawerSheet, DismissibleNavigationDrawer, DismissibleDrawerSheet, PermanentNavigationDrawer, PermanentDrawerSheet
• Rail de navigation
  • NavigationRail
• Indicateur de progression
  • CircularProgressIndicator, LinearProgressIndicator
• Case d'option
  • RadioButton
• Curseur
  • Slider, RangeSlider
• Bouton bascule
  • Bouton bascule
• Onglets
  • Tab, LeadingIconTab, TabRow, ScrollableTabRow
• Champs de texte
  • TextField, OutlinedTextField
• Barre d'application supérieure
  • TopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
• Icône
  • Icon, IconButton
• Texte
  • Texte
• Surface
  • Surface
• Mise en page
  • Scaffold
• Couleur du contenu
  • LocalContentColor

Classe de taille de fenêtre

• material3-window-size-class est une nouvelle bibliothèque qui prend en charge les classes de taille de fenêtre, qui sont un ensemble de points d'arrêt de fenêtre d'affichage définis qui permettent de concevoir, de développer et de tester des mises en page d'application redimensionnables. Vous pouvez utiliser calculateWindowSizeClass pour récupérer une instance de classe de taille de fenêtre, qui vous permettra de déterminer l'apparence de votre UI (tel que l'affichage d'un rail de navigation au lieu de la barre de navigation inférieure pour les grandes fenêtres, par exemple). Pour en savoir plus et accéder à un exemple d'utilisation, consultez la documentation de référence de l'API pour WindowSizeClass.

• Pour en savoir plus, consultez cet article de blog.

Version 1.0.0-rc01

5 octobre 2022

Publication d'androidx.compose.material3:material3:1.0.0-rc01 et d'androidx.compose.material3:material3-window-size-class:1.0.0-rc01. Liste des commits de la version 1.0.0-rc01

Modifications apportées à l'API

• Ajout d'un paramètre d'emplacement pour prendre en charge le texte dans l'API de champ de texte. (Iaac0d, b/227146125)

Version 1.0.0-beta03

21 septembre 2022

Publication d'androidx.compose.material3:material3:1.0.0-beta03 et d'androidx.compose.material3:material3-window-size-class:1.0.0-beta03. Liste des commits de la version 1.0.0-beta03

Modifications apportées à l'API

• ExposedDropdownMenuDefaults affiche désormais une valeur de marge intérieure pour les éléments de menu. (I6e1e0)
• ExposedDropdownMenuBoxScope comporte désormais un modificateur Modifier.menuAnchor() qui doit être transmis au champ de texte pour un comportement d'accessibilité (a11y) approprié. (I27fa3)
• Ajout de deux méthodes surchargées pour l'API Slider actuelle afin que les utilisateurs puissent transmettre un curseur à faire glisser sur une piste pour remplir le curseur. (I21c00)

Correction de bugs

• Remplacement de la carte de couleurs du thème sombre pour le conteneur On Error par le ton 90. (Ic5612)
• Correction visant à permettre la définition d'un arrière-plan transparent pour les petites barres d'application supérieures Material 3. (I645e2, b/245575782)

Version 1.0.0-beta02

7 septembre 2022

Publication d'androidx.compose.material3:material3:1.0.0-beta02 et d'androidx.compose.material3:material3-window-size-class:1.0.0-beta02. Liste des commits de la version 1.0.0-beta02

Modifications apportées à l'API

• Les encarts de composants par défaut introduits dans les composants m3 dans la version bêta01 ne tiennent plus compte des encarts IME.
• Le composant Material3 Scaffold dispose désormais d'un paramètre contentWindowInsets, qui permet de spécifier le nombre d'encarts à gérer pour l'emplacement du contenu. (Icf11a, b/243713323)
• Abandon de la fonction expérimentale SmallTopAppBar de Material 3 et ajout d'une fonction TopAppBar équivalente. Veuillez adopter la nouvelle fonction. (I74404, b/226918634)
• Ajout d'un contrôle sur les mouvements de glissement et d'ancrage de la barre d'application supérieure. (I15c81)
• Suppression de "startIndent" dans "Divider", déplacement la couleur vers le dernier paramètre. (If7be2)

Correction de bugs

• Les boîtes de dialogue s'identifient auprès des utilisateurs de TalkBack lorsqu'ils énoncent le mot Dialogue et qu'elles sont affichées. (I857ef)

Version 1.0.0-beta01

24 août 2022

Publication d'androidx.compose.material3:material3:1.0.0-beta01 et d'androidx.compose.material3:material3-window-size-class:1.0.0-beta01. Liste des commits de la version 1.0.0-beta01

Documentation de référence de l'API

Pour voir les derniers thèmes, composants et autres composables disponibles, consultez la présentation de la documentation de référence de l'API Compose Material 3.

Modifications apportées à l'API

• Mise à jour de la barre d'application supérieure de Material 3 pour passer d'un état entièrement réduit à un état entièrement développé. Mise à jour de la fonction de comportement TopAppBarDefaults pour qu'elle soit composable et qu'elle fournisse des valeurs par défaut pour l'état de la barre d'application supérieure et les spécifications d'animation. (I642b3)
• Mise à jour des signatures des composants du bouton d'action flottant pour correspondre à l'API Surface. (I3afaa)
• Ajout de la possibilité d'intégrer des encarts dans les barres d'application, les panneaux, les barres de navigation et les rails intégrés. Lorsqu'ils sont utilisés séparément ou avec Scaffold, ces composants gèrent automatiquement les encarts pour les développeurs. Notez que ce changement n'ajoute ni la gestion automatique des icônes de barre d'état ni la transparence de l'état et des barres de navigation. Veuillez continuer à procéder manuellement pour bénéficier d'une expérience bord à bord optimale. (I7e4e6, b/183161866)
• Mise à jour des composants par défaut afin de réduire la surface d'API et d'améliorer la flexibilité et les performances futures. (I31820)
• Réorganisation du chip et des paramètres de la feuille du panneau de navigation pour maintenir la cohérence dans l'API. (I45d0b)
• Suppression de startIndent dans "Divider" et déplacement de la couleur pour correspondre au dernier paramètre. (If7be2)

Version 1.0.0-alpha16

10 août 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha16 et d'androidx.compose.material3:material3-window-size-class:1.0.0-alpha16. Liste des commits de la version 1.0.0-alpha16

Nouvelles fonctionnalités

• Prise en charge de la spécification d'une largeur personnalisée dans un panneau de navigation. (Ia7f10)

Modifications apportées à l'API

• Réorganisation des paramètres des onglets et d'icône de début pour assurer la cohérence au sein de l'API. (Ie2637)
• Identification de BadgeDefaults comme étant expérimental. (I98ef3)
• Suppression de la fonction de panneau de navigation obsolète. (I4f2db)
• Réorganisation des paramètres de curseur dans Material 3 pour assurer la cohérence dans l'API. (I0aee7)
• Réorganisation des paramètres NavigationBar et NavigationRail pour assurer la cohérence dans l'API. (I51cda)
• Réorganisation des paramètres dans Material 3 pour assurer la cohérence dans l'API. (If4ae1)
• Réorganisation des paramètres de curseur dans Material 3 pour assurer la cohérence dans l'API. (I62673)
• Remplacement du nom du paramètre des icônes par "actions" afin d'être cohérent avec la barre d'application supérieure. (Id75be)
• Identification de Badge et BadgedBox comme étant expérimental, car l'alignement de l'ancre est toujours utilisé. (I1712e, b/236524516)
• Remplacement des annotations @ExperimentalMaterial3Api au niveau des variantes de boutons d'icône par @OptIn. (I070b5)
• Séparation du contenu d'un panneau de navigation vers son propre composable afin de permettre la définition d'une largeur personnalisée pour celui-ci. (Ia7f10)
• Suppression de Divider dans MenuDefaults et TabDefaults. (I4e33c)

Version 1.0.0-alpha15

27 juillet 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha15 et d'androidx.compose.material3:material3-window-size-class:1.0.0-alpha15. Liste des commits de la version 1.0.0-alpha15

Nouvelles fonctionnalités

• Autorisation du glissement de la barre d'application supérieure à partir de la barre elle-même. (I65c00, b/205873416)

Modifications apportées à l'API

• Mises à jour des API FilterChip et ElevatedFilterChip afin de supprimer l'emplacement selectedIcon et d'encourager la réutilisation de leadingIcon pour afficher un état sélectionné. (Ie5dc2)
• Ajout de rôles de couleur de bordure et de contour. (Id6d54)
• Correction des conventions d'attribution de noms pour les composables par défaut. (I62b27)
• Identification de ListItemDefaults et ListItemColors comme étant expérimental. (I1f3ec)
• Modifications apportées à l'API de la barre d'application supérieure pour mieux refléter la signification de ses propriétés d'état. Identification de la barre d'application supérieure comme étant expérimentale. (Ic0ad8)
• Ajout des couleurs de sélection de texte à TextFieldColors pour une meilleure visibilité. (Iba1b8)
• Ajout de ButtonDefault.ButtonWithIconContentPadding à utiliser avec les boutons contenant une icône. (I2bf9c)
• Identification des champs de texte comme expérimentaux pour gagner en flexibilité lors des modifications futures de l'API. (I127b5)
• Suppression de l'annotation @ExperimentalMaterial3Api dans la fonction Checkbox. (I5eefc)
• Suppression de l'annotation @ExperimentalMaterial3Api dans la fonction RadioButton. (I17e2a)
• Suppression de l'annotation @ExperimentalMaterial3Api dans les fiches non interactives. (I9bd49)
• Mise à jour de divers objets par défaut des composants pour inclure des couleurs, des formes, etc. (I96e11)

Correction de bugs

• Suppression des icônes de fin ne fonctionnant pas dans les exemples de chips d'entrée pour éviter toute confusion auprès des utilisateurs dans l'application de catalogue. (I9846a)

Version 1.0.0-alpha14

29 juin 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha14 et d'androidx.compose.material3:material3-window-size-class:1.0.0-alpha14. Liste des commits de la version 1.0.0-alpha14

Nouvelles fonctionnalités

• Ajout de l'implémentation de la liste M3 ; consultez la documentation pour voir un exemple d'utilisation. (Id7a20)

Modifications apportées à l'API

• Remplacement du nom de paramètre "values" par "value" dans RangeSlider. (I3b79a)
• Modifications d'API apportées à l'implémentation d'InputChip pour permettre la sélection d'un état conformément aux spécifications de Material Design. Prise en charge supplémentaire au niveau des couleurs FilterChip lorsque l'état désactivé est sélectionné. (I55244, b/235792432)
• Ajout du bouton d'action flottant par défaut BottomAppBar. (Ida4c8)
• Ajout de ColorScheme.surfaceColorAtElevation. (Id41af)
• Mise à jour des interfaces dans les bibliothèques Compose, désormais créées à l'aide des méthodes d'interface jdk8 par défaut. (I5bcf1)
• Prise en charge de l'implémentation de la fonction Comparable par WindowWidthSizeClass et WindowHeightSizeClass, qui permet de les comparer en utilisant des opérateurs (<, <=, >=, >) et d'autres API. (I747d0)

Correction de bugs

• Mise à jour de l'exemple de badge pour fournir une description de contenu plus pertinente. (I10b9d)
• Ajout d'une option permettant d'utiliser la taille de police du système dans le sélecteur de thème du catalogue Material 3. (I10605)
• Ajout d'un exemple de code pour le badge et les indicateurs de progression indéterminés. (I8fbe0)

Version 1.0.0-alpha13

1er juin 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha13 et d'androidx.compose.material3:material3-window-size-class:1.0.0-alpha13. Liste des commits de la version 1.0.0-alpha13

Modifications apportées à l'API

• Conservation de la position de la barre d'application supérieure lors d'un changement de configuration. (I10459, b/216160958)

Version 1.0.0-alpha12

18 mai 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha12 et d'androidx.compose.material3:material3-window-size-class:1.0.0-alpha12. Liste des commits de la version 1.0.0-alpha12

Correction de bugs

• Le parent du curseur peut maintenant avoir une largeur correspondant à 0. (b/231707291)

Version 1.0.0-alpha11

11 mai 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha11 et d'androidx.compose.material3:material3-window-size-class:1.0.0-alpha11. Liste des commits de la version 1.0.0-alpha11

Nouvelles fonctionnalités

• Ajout de RangeSlider à Material 3. (I18e38)
• Ajout de la compatibilité AssistChip et InputChip avec Material 3. (I0d25a)
• Ajout de la compatibilité FilterChip et SuggestionChip avec Material 3. (I9fdf3)

Modifications apportées à l'API

• Remplacement du nom du composable TextFieldDefaults.BorderStroke permettant de tracer un trait de bordure dans OutlinedTextField par TextFieldDefaults.BorderBox. (I5f295)
• Changement des modifications visuelles m3. (Iab30e)
• Prise en charge de la transmission des couleurs aux boutons d'icône standards. (Ia2445)

Correction de bugs

• Ajout d'une vérification lint pour Material/Scaffold, afin d'assurer l'utilisation de la marge intérieure. (I72293, b/226951418)

Version 1.0.0-alpha10

20 avril 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha10 et d'androidx.compose.material3:material3-window-size-class:1.0.0-alpha10. Liste des commits de la version 1.0.0-alpha10

Nouvelles fonctionnalités

• material3-window-size-class est une nouvelle bibliothèque qui prend en charge les classes de taille de fenêtre, qui sont un ensemble de points d'arrêt de fenêtre d'affichage définis qui permettent de concevoir, de développer et de tester des mises en page d'application redimensionnables. Vous pouvez utiliser calculateWindowSizeClass pour récupérer une instance de classe de taille de fenêtre, qui vous permettra de déterminer l'apparence de votre UI (tel que l'affichage d'un rail de navigation au lieu de la barre de navigation inférieure pour les grandes fenêtres, par exemple). Pour en savoir plus et accéder à un exemple d'utilisation, consultez la documentation de référence de l'API pour WindowSizeClass. Pour vous familiariser avec les définitions de classe de taille de fenêtre, consultez les conseils publics sur la prise en charge de différentes tailles d'écran.

Modifications apportées à l'API

• Ajout de l'élévation du bouton d'action flottant par défaut pour BottomAppBar, suppression du lambda de fin dans le champ BottomAppBar avec le bouton d'action flottant. (I92c47)
• Ajout des éléments Material 3 FilledIconButton, FilledTonalIconButton et OutlinedIconButton. (Ib2bda)
• Mise à jour de l'API Material 3 Snackbar afin d'accepter les valeurs de couleur pour l'action facultative et l'action "Ignorer". (Ibe4b4)
• Abandon de la consommation partielle (position OR vers le bas) dans PointerInputChange. Vous pouvez utiliser consume() pour consommer complètement le changement. Vous pouvez utiliser isConsumed pour déterminer si le changement a déjà été consommé par un tiers.
• Mise à jour de PointerInputChange::copy(), qui crée désormais toujours une copie superficielle. Autrement dit, les copies de PointerInputChange seront consommées une fois que l'une des copies aura été consommée. Si vous souhaitez créer un PointerInputChange non associé, utilisez plutôt le constructeur. (Ie6be4, b/225669674)
• Modifications apportées à l'API Cards afin de recevoir les couleurs du conteneur et du contenu via une interface CardColors, et de permettre la désactivation des fiches cliquables. (I927df)
• Remplacement du nom du paramètre backgroundColor par containerColor dans les champs de texte Material 3 afin d'améliorer la cohérence avec les autres composants. (I6fbd9)

Correction de bugs

• Mises à jour de l'élément standard IconButton pour qu'il corresponde avec la spécification Material 3. (I09Eab)
• Déplacement de la hauteur de la barre supérieure de Material Scaffold vers la marge intérieure qui s'affiche au niveau du contenu, de sorte que le contenu apparaisse sous la barre d'application supérieure. Si les valeurs PaddingValues sont ignorées, le contenu risque d'être obscurci par la barre supérieure. (I83cbc, b/217776202)

Version 1.0.0-alpha09

6 avril 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09

Nouvelles fonctionnalités

• Ajout de l'API Material 3 Switch. (I2c3ad)

Modifications apportées à l'API

• Ajout de la prise en charge des menus déroulants comportant des champs de texte (également appelés "menus déroulants exposés" ou "boîtes combinées"). (I1b832)
• Ajout du paramètre de forme ajouté au sous-système MaterialTheme et Shape. (I37426)
• Ajout d'un paramètre développé à ExtendedFloatingActionButton pour contrôler si le bouton d'action flottant est développé ou réduit, avec des animations entre chaque état. Ajout d'une surcharge pour les boutons d'action flottants étendus, avec un texte de fin sans icône. (Iba7f1)

Version 1.0.0-alpha08

23 mars 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08

Nouvelles fonctionnalités

• Ajout de la prise en charge des champs de texte Material 3. (I795cc, b/199377790)

Modifications apportées à l'API

• Ajout d'un séparateur par défaut au menu. (I01374)
• Ajout du paramètre de couleur surfaceTint à la classe ColorScheme. (I2f558)

Correction de bugs

• Correction au niveau du bouton Material3 pour lire sa valeur de style de texte par défaut à partir du MaterialTheme. (Ie62fc)

Version 1.0.0-alpha07

9 mars 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

Modifications apportées à l'API

• Mises à jour de l'API Material 3 Surface qui restaure les fonctions surchargées pour les surfaces cliquables, et ajout d'une fonction prenant en charge les surfaces qui peuvent être sélectionnées et activées. (I4bf18)
• Mise à jour de LazyVerticalGrid et LazyHorizontalGrid, désormais considérés comme stables. (I307c0)
• LazyVerticalGrid/LazyHorizontalGrid et des API associées ont été déplacées dans le sous-package .grid. Remplacez vos importations d'androidx.compose.foundation.lazy par androidx.compose.foundation.lazy.grid. (I2d446)
• Annulation d'une modification précédente qui consistait à ne dépendre que d'une vue pour WindowInsetsControllerCompat, et à exiger de nouveau une fenêtre pour gérer certains indicateurs de fenêtre. Abandon de ViewCompat.getWindowInsetsController au profit de WindowCompat.getInsetsController pour assurer l'utilisation de la fenêtre appropriée (par exemple, si la vue se trouve dans une boîte de dialogue). (I660ae, b/219572936)
• Ajout d'une API LazyVerticalGrid permettant de définir les tailles de l'axe transversal. (I17723)

Correction de bugs

• Mises à jour de l'API Card pour suivre les modifications apportées à l'API Surface. (I3c8b9)

Version 1.0.0-alpha06

23 février 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Modifications apportées à l'API

• Ajout de NavigationDrawerItem, qui représente une destination unique dans les panneaux. (Ic396f, b/218286829)
• Ajout de PermanentNavigationDrawer et DismissibleNavigationDrawer en tant qu'API expérimentales. Ces panneaux conviennent bien aux appareils à grand écran. (I5f8ab, b/218286829)
• Ajout de la prise en charge de la barre d'application Material 3. (Ic432a)
• Remplacement du nom de NavigationDrawer par ModalNavigationDrawer. (I1807d, b/218286829)
• Ajout des jetons et de la classe Material 3 Slider. (I1ccee)
• Ajout de l'implémentation de "Tab" ; consultez la documentation pour voir un exemple d'utilisation. (Ie0146)

Correction de bugs

• Correction d'un problème qui provoquait la sélection d'un titre de barre d'application vide dans la navigation linéaire du lecteur d'écran TalkBack. (Id4690)
• Ajout de IconSize au groupe FloatingActionButtonDefaults. (Ia71cf)
• Correction d'un bug pour les boutons AlertDialog masqués lorsqu'un texte long est ajouté avec un élément LazyColumn. (Ib2cc9, b/216663029)

Version 1.0.0-alpha05

9 février 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05.

Nouvelles fonctionnalités

Ajout de composants Material Design 3

• Menu déroulant
  • DropdownMenu, DropdownMenuItem
• Fiches
  • Card, OutlinedCard, ElevatedCard

Modifications apportées à l'API

• Abandon de la fonction Surface qui accepte un rappel onClick. Les surfaces cliquables doivent être créées avec InteractionSource et Modifier.clickable(). (I211c6)
• Ajout de la prise en charge de l'élévation en cas de pression et de ciblage des boutons d'action flottants. (Ibb584)
• Modification de l'API Surface pour recevoir une InteractionSource qui permet de contrôler son apparence dans différents états. (Iafbc8)

Correction de bugs

• Ajout des couleurs tertiaires manquantes dans les combinaisons de couleurs dynamiques. (I456c4, b/214588434)

Version 1.0.0-alpha04

26 janvier 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Modifications apportées à l'API

• Ajout de NonRestartableComposable aux méthodes correspondant à des surcharges de méthodes existantes sans logique complexe. Cela réduit le nombre de vérifications (d'égalité) de la mémorisation générées par le compilateur pour tous les paramètres répétés dans la fonction interne appelée. (I90490)
• Ajout du séparateur Material 3. (Ica5fc)
• Identification des éléments "Checkbox" et "RadioButton" avec une annotation d'API expérimentale. (Ie44bb)
• Ajout de la prise en charge des indicateurs de progression de Material 3. (Iff232, b/205023841)

Correction de bugs

• Mise à jour une couleur de conteneur TextButton's désactivée pour qu'elle soit transparente. (I6b248, b/213339737)

Version 1.0.0-alpha03

12 janvier 2022

Publication d'androidx.compose.material3:material3:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Correction de bugs

• Ajout de LocalIndication au MaterialTheme de Material 3. (I7ce4e)
• Correction de l'arrondi d'angle appliqué aux cases à cocher. (I38b03, b/175198975, b/202309440)

Mises à jour de la dépendance

• Elle dépend désormais de Kotlin 1.6.10.

Version 1.0.0-alpha02

1er décembre 2021

Publication d'androidx.compose.material3:material3:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Nouvelles fonctionnalités

• Ajout de la prise en charge des cases à cocher et des cases d'option.
• Mise à jour pour assurer la compatibilité avec Kotlin 1.6.0.

Modifications apportées à l'API

• Suppression du panneau de Material 3 Scaffold. (I04f51)
• Ajout de la prise en charge de Checkbox pour Material 3. (Id5542)
• Ajout de la prise en charge de RadioButton pour Material 3. (I20334)

Correction de bugs

• Réduction rayon d'onde de l'élément IconButton de 40 dp à 20 dp. (I68bbe, b/206674345)
• Changement du chemin d'accès rapide de la chaîne du port pour Text à partir de compose.material. (I30b03)
• Correction du bouton codé en dur pour qu'il soit toujours activé. (Iea832, b/205335456)

Version 1.0.0-alpha01

27 octobre 2021

Publication d'androidx.compose.material3:material3:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

Thématisation Material Design 3 et couleur dynamique Material You

• MaterialTheme
• Couleur
  • ColorScheme
  • lightColorScheme, darkColorScheme
• Couleur dynamique
  • dynamicLightColorScheme, dynamicDarkColorScheme
• Typographie
  • Typography

Composants Material Design 3

• Boutons
  • Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
• Bouton d'action flottant et bouton d'action flottant étendu
  • SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
• Boîtes de dialogue
  • AlertDialog
• Barre de navigation
  • NavigationBar
• Panneau de navigation
  • NavigationDrawer
• Rail de navigation
  • NavigationRail
• Barre d'application supérieure
  • SmallTopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
• Badge
  • Badge, BadgedBox
• Icône
  • Icon, IconButton
• Texte
  • Text
• Surface
  • Surface
• Mise en page
  • Scaffold
• Couleur du contenu
  • LocalContentColor

Pour en savoir plus, consultez la section Material Design 3 et Material You du guide sur la thématisation Material de Compose.