Cette page a été traduite par l'API Cloud Translation.

adaptatif Material 3 de Compose

Documentation de référence de l'API
androidx.compose.material3.adaptive

Utiliser la bibliothèque adaptative Material 3 pour créer des interfaces utilisateur adaptatives qui s'adaptent automatiquement à la fenêtre actuelle telles que les classes de taille de fenêtre ou les positions des appareils. Cette bibliothèque fournit à la fois les implémentations d'échafaudage par défaut et les composables de blocs de construction nécessaires pour créer vos propres expériences personnalisées.

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

Déclarer des dépendances

Pour ajouter une dépendance à 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.adaptive:adaptive:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

Kotlin

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02")
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

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 Adaptive version 1.1

Version 1.1.0-alpha02

4 septembre 2024

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

Nouvelles fonctionnalités

La personnalisation du mouvement (I0bf9c), (I80e66) est prise en charge pour permettre aux créateurs de modifier les mouvements par défaut lors des changements d'état adaptatifs de l'échafaudage. Les créateurs peuvent choisir parmi un ensemble de transitions d'entrée et de sortie par défaut, ou implémenter des transitions personnalisées pures à l'aide des informations fournies par les nouvelles étendues de mouvement.
Implémentation d'une animation de fondu pour les poignées de déplacement de l'expansion du volet. (46e3c69)
Fonction d'enregistrement PaneExpansionState mémorisée (61ff76f)

Modifications apportées à l'API

Ajout d'API d'expansion de volet manquantes aux échafaudages. (Ic5bc0)
Remplacement du nom ThreePaneScaffoldDestinationItem.content par contentKey. L'argument de type par défaut rememberListDetailPaneScaffoldNavigator et rememberSupportingPaneScaffoldNavigator est passé de Nothing à Any. (I58749).
Marquage de ThreePaneScaffoldState comme stable. (I64aec)
Définition d'un champ d'application pour les paramètres de poignée de déplacement. (Ic0aa2)

Version 1.1.0-alpha01

21 août 2024

Publication d'androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01. La version 1.1.0-alpha01 contient ces commits.

Nouvelles fonctionnalités

Introduction de la prise en charge de l'expansion des volets pour les échafaudages adaptatifs.

Modifications apportées à l'API

Introduction des API d'expansion de volet en mode public. (I301d6)
Introduction de ThreePaneScaffoldState aux transitions de valeurs du volet de contrôle. Ajout de surcharges ListDetailPaneScaffold et SupportingPaneScaffold qui acceptent cet état. (I5db3b).
Introduction de la clé d'expansion du volet et de l'interface du fournisseur de clés. (Id621f)

Correction de bugs

Correction du calcul de partition incorrect en cas d'exclusion d'une charnière. (9dfd483).

Compose Material3 Adaptive version 1.0

Version 1.0.0

4 septembre 2024

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

Principales fonctionnalités de la version 1.0.0

Les fonctions composables en une ligne currentWindowSize(), collectFoldingFeaturesAsState() et currentWindowAdaptiveInfo() permettent d'obtenir les informations sur les fenêtres requises pour adapter les applications, comme la taille des fenêtres et les fonctionnalités de pliage.
ListDetailPaneScaffold et SupportingPaneScaffold pour fournir deux mises en page standards Material3 qui s'adaptent automatiquement aux différentes configurations de fenêtre. Ces deux échafaudages sont également entièrement personnalisables afin de répondre aux différents besoins des fabricants.
ThreePaneScaffoldNavigator et ses fonctions de mémorisation pertinentes, rememberListDetailPaneScaffoldNavigator() et rememberSupportingPaneScaffoldNavigator() pour fournir des solutions de navigation dans un échafaudage adaptatif, qui peut afficher plusieurs destinations de navigation en même temps, en comparaison avec la configuration courante pour une destination à la fois dans le monde non adaptatif.
Animations Material3 intégrées par défaut lorsque vous modifiez les états de l'échafaudage adaptatif.

Version 1.0.0-rc01

21 août 2024

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

Correction de bugs

Correction du calcul de partition incorrect en cas d'exclusion d'une charnière. (9dfd483).

Version 1.0.0-beta04

26 juin 2024

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

Correction de bugs

Résolution du problème de mise à jour de la mise en page lorsque les contours de la charnière sont mis à jour. (71e9cf1).

Version 1.0.0-beta03

12 juin 2024

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

Correction de bugs

Correction des plantages causés par une résolution de dépendances incorrecte dans la version bêta02.

Version 1.0.0-beta02

29 mai 2024

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

Version 1.0.0-beta01

14 mai 2024

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

Version 1.0.0-alpha12

1er mai 2024

Publication d'androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12. La version 1.0.0-alpha12 contient ces commits.

Modifications apportées à l'API

Ajout des informations isFlat à HingeInfo. (Ie0516, b/333784198)
Rendre les API adaptatives non expérimentales. (I1d038)
Possibilité de rendre les API de mise en page adaptative non expérimentales. (Id23df)
Remplacement de BackNavigationBehavior d'une énumération par une classe de valeurs. (Id8757)

Correction de bugs

Modification de la fraction de transition en lambda. (I6f5a9)
Correction du problème d'état initial de SizeTracker. (18326a9)
Inclusion de la liste de charnières dans le contrôle d'égalité Posture (6687137)

Version 1.0.0-alpha11

17 avril 2024

Publication d'androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11. La version 1.0.0-alpha11 contient ces commits.

Modifications apportées à l'API

sceller les interfaces de champ d'application ; (Iefa57).
Présentez AnimatedPaneScope. (I62d73, b/332750742).
Assurez-vous que AdaptStrategy est scellé et stable. (Ia28b2).
Introduction d'une méthode de copie de PaneScaffoldDirective. (I9291f).
Marquer ThreePaneScaffoldScope comme expérimental (I9d527).
Fournir des API d'échafaudage faciles à utiliser qui prennent en charge la navigation. (I263f0, b/321010778).

Version 1.0.0-alpha10

3 avril 2024

Publication d'androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10. La version 1.0.0-alpha10 contient ces commits.

Modifications apportées à l'API

Rendez la largeur par défaut adaptative et personnalisable. (Ic3abc).
Renommer les fonctions de calcul de la directive d'échafaudage (I10855).
Suppression des marges intérieures et des encarts des API scaffold. (I786f8).
Ajout de méthodes de mémorisation du navigateur sans types génériques. (I607c3).

Version 1.0.0-alpha09

20 mars 2024

Publication d'androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09. La version 1.0.0-alpha09 contient ces commits.

Modifications apportées à l'API

Ajout de champs de transition d'état à ThreePaneScaffoldScope. (I3d917).
Réorganisez les paramètres d'échafaudage (scaffold). (I4dff5).
Indiquez la valeur par défaut du paramètre de modificateur AnimatedPane. (I77dd7).

Correction de bugs

Incluez la taille de l'espace vide dans les mouvements de volet. (a3174ca).

Version 1.0.0-alpha08

6 mars 2024

Publication d'androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08. La version 1.0.0-alpha08 contient ces commits.

Nouvelles fonctionnalités

Implémentation du glissement retardé lors du changement de volets. (I1a38e).

Modifications apportées à l'API

Suppression de l'interface ThreePaneScaffoldState. (I63f23).

Version 1.0.0-alpha07

21 février 2024