Créer une interface utilisateur responsive avec ConstraintLayout Fait partie d'Android Jetpack.
ConstraintLayout
vous permet de créer de grandes mises en page complexes avec une hiérarchie des vues plate, sans groupes de vues imbriqués. Il est semblable à RelativeLayout
dans la mesure où toutes les vues sont disposées en fonction des relations entre les vues frères et la mise en page parente, mais il est plus flexible que RelativeLayout
et plus facile à utiliser avec l'éditeur de mise en page d'Android Studio.
Toute la puissance de ConstraintLayout
est disponible directement à partir des outils visuels de l'éditeur de mise en page, car l'API de mise en page et l'éditeur de mise en page sont spécialement conçus l'un pour l'autre. Vous pouvez créer entièrement votre mise en page avec ConstraintLayout
en la faisant glisser au lieu de modifier le fichier XML.
Cette page explique comment créer une mise en page avec ConstraintLayout
dans Android Studio 3.0 ou version ultérieure. Pour en savoir plus sur l'éditeur de mise en page, consultez Créer une UI avec l'éditeur de mise en page.
Pour voir les diverses mises en page que vous pouvez créer avec ConstraintLayout
, consultez le projet d'exemples de mise en page avec contrainte sur GitHub.
Présentation des contraintes
Pour définir la position d'une vue dans ConstraintLayout
, vous devez ajouter au moins une contrainte horizontale et une contrainte verticale pour la vue. Chaque contrainte représente une connexion ou un alignement à une autre vue, à la mise en page parente ou à une ligne invisible. Chaque contrainte définit la position de la vue le long de l'axe vertical ou horizontal. Chaque vue doit comporter au moins une contrainte pour chaque axe, mais souvent d'autres sont nécessaires.
Lorsque vous déposez une vue dans l'éditeur de mise en page, elle reste là où vous la quittez, même si elle ne présente aucune contrainte. L'objectif est de faciliter les modifications. Si une vue ne présente aucune contrainte lorsque vous exécutez votre mise en page sur un appareil, elle est dessinée en position [0,0] (coin supérieur gauche).
Dans la figure 1, la mise en page est correcte dans l'éditeur, mais il n'y a pas de contrainte verticale sur la vue C. Lorsque cette mise en page est dessinée sur un appareil, la vue C s'aligne horizontalement sur les bords gauche et droit de la vue A, mais elle apparaît en haut de l'écran, car elle ne présente aucune contrainte verticale.
![](https://developer.android.com/static/training/constraint-layout/images/constraint-fail_2x.png?authuser=6&hl=fr)
Figure 1 : L'éditeur affiche la vue C sous A, mais n'a aucune contrainte verticale.
![](https://developer.android.com/static/training/constraint-layout/images/constraint-fail-fixed_2x.png?authuser=6&hl=fr)
Figure 2. La vue C est désormais contrainte verticalement sous la vue A.
Bien qu'une contrainte manquante ne provoque pas d'erreur de compilation, l'éditeur de mise en page indique des contraintes manquantes comme une erreur dans la barre d'outils. Pour afficher les erreurs et d'autres avertissements, cliquez sur Afficher les avertissements et les erreurs
.
Pour vous aider à éviter de manquer des contraintes, l'éditeur de mise en page ajoute automatiquement des contraintes grâce aux fonctionnalités Se connecter automatiquement et déduire des contraintes.
Ajouter ConstraintLayout à votre projet
Pour utiliser ConstraintLayout
dans votre projet, procédez comme suit:
- Assurez-vous que le dépôt
maven.google.com
est déclaré dans le fichiersettings.gradle
:Groovy
dependencyResolutionManagement { ... repositories { google() } )
Kotlin
dependencyResolutionManagement { ... repositories { google() } }
- Ajoutez la bibliothèque en tant que dépendance dans le fichier
build.gradle
au niveau du module, comme illustré dans l'exemple suivant. La dernière version peut être différente de celle présentée dans l'exemple.Groovy
dependencies { implementation "androidx.constraintlayout:constraintlayout:2.2.0-alpha14" // To use constraintlayout in compose implementation "androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha14" }
Kotlin
dependencies { implementation("androidx.constraintlayout:constraintlayout:2.2.0-alpha14") // To use constraintlayout in compose implementation("androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha14") }
- Dans la barre d'outils ou la notification de synchronisation, cliquez sur Sync Project with Gradle Files (Synchroniser le projet avec les fichiers Gradle).
Vous êtes maintenant prêt à créer votre mise en page avec ConstraintLayout
.
Convertir une mise en page
![](https://developer.android.com/static/training/constraint-layout/images/layout-editor-convert-to-constraint_2x.png?authuser=6&hl=fr)
Figure 3. Menu permettant de convertir une mise en page au format ConstraintLayout
.
Pour convertir une mise en page existante en mise en page avec contrainte, procédez comme suit:
- Ouvrez votre mise en page dans Android Studio, puis cliquez sur l'onglet Design (Conception) en bas de la fenêtre de l'éditeur.
- Dans la fenêtre Component Tree (Arborescence des composants), effectuez un clic droit sur la mise en page, puis cliquez sur Convert LinearLayout to ConstraintLayout (Convertir LinearLayout en ConstraintLayout).
Créer une nouvelle mise en page
Pour démarrer un nouveau fichier de mise en page de contrainte, procédez comme suit:
- Dans la fenêtre Project (Projet), cliquez sur le dossier du module et sélectionnez File > New > XML > Layout XML (Fichier > Nouveau > XML > Mise en page XML).
- Saisissez un nom pour le fichier de mise en page, puis "androidx.constraintlayout.widget.ConstraintLayout" pour la balise racine.
- Cliquez sur Finish (Terminer).
Ajouter ou supprimer une contrainte
Pour ajouter une contrainte, procédez comme suit:
Vidéo 1. Le côté gauche d'une vue est limité sur le côté gauche de l'élément parent.
Faites glisser une vue de la fenêtre Palette vers l'éditeur.
Lorsque vous ajoutez une vue dans un élément
ConstraintLayout
, elle s'affiche dans un cadre de délimitation avec des poignées de redimensionnement carrées à chaque angle et des poignées de contrainte circulaires de chaque côté.- Cliquez sur la vue pour la sélectionner.
- Effectuez l'une des opérations suivantes :
- Cliquez sur une poignée de contrainte et faites-la glisser vers un point d'ancrage disponible. Ce point peut être le bord d'une autre vue, le bord de la mise en page ou une ligne de repère. Notez que lorsque vous faites glisser la poignée de contrainte, l'éditeur de mise en page affiche des ancres de connexion potentielles et des superpositions bleues.
Cliquez sur l'un des boutons Create a connection (Créer une connexion)
dans la section Layout (Mise en page) de la fenêtre Attributes, comme illustré dans la figure 4.
Figure 4. La section Mise en page de la fenêtre Attributs vous permet de créer des connexions.
Lorsque la contrainte est créée, l'éditeur lui attribue une marge par défaut pour séparer les deux vues.
Lorsque vous créez des contraintes, tenez compte des règles suivantes:
- Chaque vue doit avoir au moins deux contraintes: une horizontale et une verticale.
- Vous ne pouvez créer des contraintes qu'entre une poignée de contrainte et un point d'ancrage qui partagent le même plan. Un plan vertical (les côtés gauche et droit) d'une vue ne peut être contraint qu'à un autre plan vertical, et les références ne peuvent être contraints qu'à d'autres lignes de base.
- Chaque handle de contrainte peut être utilisé pour une seule contrainte, mais vous pouvez créer plusieurs contraintes à partir de différentes vues sur le même point d'ancrage.
Vous pouvez supprimer une contrainte de l'une des manières suivantes:
- Cliquez sur une contrainte pour la sélectionner, puis sur Supprimer.
Cliquez sur une ancre de contrainte en maintenant la touche Ctrl enfoncée (Commande tout en cliquant sous macOS). La contrainte devient rouge pour indiquer que vous pouvez cliquer dessus pour la supprimer, comme illustré dans la figure 5.
Figure 5 : Une contrainte rouge indique que vous pouvez cliquer dessus pour la supprimer.
Dans la section Layout (Mise en page) de la fenêtre Attributes (Attributs), cliquez sur une ancre de contrainte, comme illustré dans la figure 6.
Figure 6. Cliquez sur une ancre de contrainte pour la supprimer.
Vidéo 2. Ajout d'une contrainte qui s'oppose à une contrainte existante.
Si vous ajoutez des contraintes opposées à une vue, les lignes de contrainte s'enroulent comme un ressort pour indiquer les forces opposées, comme illustré dans la vidéo 2. L'effet est particulièrement visible lorsque la taille de la vue est définie sur "fixe" ou "encapsuler le contenu", auquel cas la vue est centrée entre les contraintes. Si vous souhaitez plutôt que la vue s'étire pour respecter les contraintes, modifiez la taille pour qu'elle corresponde aux contraintes. Si vous souhaitez conserver la taille actuelle, mais déplacer la vue pour qu'elle ne soit pas centrée, ajustez le biais de contrainte.
Vous pouvez utiliser des contraintes pour obtenir différents types de comportement de mise en page, comme décrit dans les sections suivantes.
Position du parent
Appliquez une contrainte au côté d'une vue par rapport au bord correspondant de la mise en page.
Dans la figure 7, le côté gauche de la vue est connecté au bord gauche de la mise en page parente. Vous pouvez définir la distance par rapport au bord à l'aide d'une marge.
![](https://developer.android.com/static/training/constraint-layout/images/parent-constraint_2x.png?authuser=6&hl=fr)
Figure 7 Contrainte horizontale appliquée au parent.
Position de la commande
Définissez l'ordre d'apparition de deux vues, verticalement ou horizontalement.
Dans la figure 8, B est obligé de toujours se trouver à droite de A, et C est limité en dessous de A. Cependant, ces contraintes n'impliquent pas d'alignement. Par conséquent, B peut toujours se déplacer vers le haut et vers le bas.
![](https://developer.android.com/static/training/constraint-layout/images/position-constraint_2x.png?authuser=6&hl=fr)
Figure 8. Contrainte horizontale et verticale.
Emplacement D
Alignez le bord d'une vue sur le même bord d'une autre vue.
Dans la figure 9, le côté gauche de B est aligné sur le côté gauche de A. Si vous souhaitez aligner les centres d'affichage, créez une contrainte des deux côtés.
Vous pouvez décaler l'alignement en faisant glisser la vue vers l'intérieur à partir de la contrainte. Par exemple, la figure 10 montre B avec un décalage de 24 dp. Le décalage est défini par la marge de la vue contrainte.
Vous pouvez également sélectionner toutes les vues que vous souhaitez aligner, puis cliquer sur Align (Aligner) dans la barre d'outils pour sélectionner le type d'alignement.
![](https://developer.android.com/static/training/constraint-layout/images/alignment-constraint_2x.png?authuser=6&hl=fr)
Figure 9. Contrainte d'alignement horizontal.
![](https://developer.android.com/static/training/constraint-layout/images/alignment-constraint-offset_2x.png?authuser=6&hl=fr)
Figure 10. Contrainte d'alignement horizontal de décalage.
Alignement de la ligne de base
Alignez la ligne de base du texte d'une vue sur celle d'une autre vue.
Dans la figure 11, la première ligne de B est alignée sur le texte de A.
Pour créer une contrainte de référence, effectuez un clic droit sur la vue de texte que vous souhaitez contraindre, puis cliquez sur Show Baseline (Afficher la référence). Cliquez ensuite sur la ligne de base du texte et faites-la glisser vers une autre ligne de base.
![](https://developer.android.com/static/training/constraint-layout/images/baseline-constraint_2x.png?authuser=6&hl=fr)
Figure 11 : Contrainte d'alignement de référence.
Appliquez une contrainte à une consigne
Vous pouvez ajouter une ligne verticale ou horizontale qui vous permet de limiter les vues et qui est invisible pour les utilisateurs de votre application. Vous pouvez positionner la consigne dans la mise en page en fonction d'unités de dp ou d'un pourcentage par rapport au bord de la mise en page.
Pour créer une consigne, cliquez sur Guidelines (Consignes) dans la barre d'outils, puis cliquez sur Add Vertical Guideline (Ajouter une ligne directrice verticale) ou Add Horizontal Guideline (Ajouter une ligne directrice horizontale).
Faites glisser la ligne en pointillés pour la repositionner, puis cliquez sur le cercle au bord de la ligne de repère pour activer/désactiver le mode de mesure.
![](https://developer.android.com/static/training/constraint-layout/images/guideline-constraint_2x.png?authuser=6&hl=fr)
Figure 12. Vue limitée à une consigne.
Contrainte à une barrière
Comme pour les consignes, une barrière est une ligne invisible à laquelle vous pouvez contraindre des vues, sauf qu'elle ne définit pas sa propre position. Au lieu de cela, la position de la barrière se déplace en fonction de la position des vues qu'elle contient. Cela est utile lorsque vous souhaitez limiter une vue à un ensemble de vues plutôt qu'à une vue spécifique.
Par exemple, dans la figure 13, la vue C est contrainte du côté droit d'une barrière. La barrière est définie sur la "fin" (ou sur le côté droit, dans une mise en page de gauche à droite) des vues A et B. La barrière se déplace selon que le côté droit de la vue A ou de la vue B se trouve le plus à droite.
Pour créer une barrière, procédez comme suit:
- Cliquez sur Guidelines (Consignes)
dans la barre d'outils, puis sur Ajouter une barrière verticale ou Ajouter une barrière horizontale.
- Dans la fenêtre Component Tree (Arborescence des composants), sélectionnez les vues de votre choix à l'intérieur de la barrière, puis faites-les glisser dans le composant "barrier".
- Sélectionnez la barrière dans l'arborescence des composants, ouvrez la fenêtre Attributes (Attributs)
, puis définissez barrierDirection.
Vous pouvez maintenant créer une contrainte à partir d'une autre vue de la barrière.
Vous pouvez également limiter les vues qui se trouvent à l'intérieur de cette barrière. De cette façon, vous pouvez aligner toutes les vues de la barrière les unes par rapport aux autres, même si vous ne savez pas quelle vue est la plus longue ou la plus haute.
Vous pouvez également inclure une consigne à l'intérieur d'une barrière pour garantir une position "minimale" de celle-ci.
![](https://developer.android.com/static/training/constraint-layout/images/barrier-constraint_2x.png?authuser=6&hl=fr)
Figure 13. La vue C est contrainte par une barrière, qui se déplace en fonction de la position et de la taille des vues A et B.
Ajuster le biais de contrainte
Lorsque vous ajoutez une contrainte des deux côtés d'une vue et que la taille de la vue pour la même dimension est "fixe" ou "encapsuler le contenu", la vue est centrée entre les deux contraintes avec un biais de 50% par défaut. Vous pouvez ajuster le biais en faisant glisser le curseur dans la fenêtre Attributes (Attributs) ou en faisant glisser la vue, comme illustré dans la vidéo 3.
Si vous souhaitez plutôt que la vue s'étire pour respecter les contraintes, modifiez la taille pour qu'elle corresponde aux contraintes.
Vidéo 3. Ajuster le biais de contrainte.
Ajuster la taille de la vue
![](https://developer.android.com/static/images/training/constraint-layout/constraint-layout-editor-attributes-2x.png?authuser=6&hl=fr)
Figure 14. Lorsque vous sélectionnez une vue, la fenêtre Attributes (Attributs) inclut des commandes pour le ratio de taille 1, 2 suppression de contraintes, 3 mode hauteur ou largeur, 4 marges et biais de contrainte 5. Vous pouvez également mettre en surbrillance des contraintes individuelles dans l'éditeur de mise en page en cliquant dessus dans la liste des contraintes 6.
Vous pouvez utiliser les poignées d'angle pour redimensionner une vue, mais cela code en dur la taille : la vue ne se redimensionne pas pour différents contenus ou tailles d'écran. Pour sélectionner un autre mode de dimensionnement, cliquez sur une vue et ouvrez la fenêtre Attributes (Attributs) à droite de l'éditeur.
Vers le haut de la fenêtre Attributes (Attributs) se trouve l'inspecteur de vue, qui inclut des commandes pour plusieurs attributs de mise en page, comme illustré dans la figure 14. Cette option n'est disponible que pour les vues avec une mise en page de contrainte.
Vous pouvez modifier la façon dont la hauteur et la largeur sont calculées en cliquant sur les symboles indiqués par l'icône 3 de la figure 14. Ces symboles représentent le mode Taille, comme suit. Cliquez sur le symbole pour passer d'un paramètre à l'autre:
-
Fixe: spécifiez une dimension spécifique dans la zone de texte suivante ou redimensionnez la vue dans l'éditeur.
-
Encapsuler le contenu: la vue ne se développe que si nécessaire pour s'adapter à son contenu.
- layout_restrictedWidth
-
Faire correspondre les contraintes: la vue se développe autant que possible pour respecter les contraintes de chaque côté, en tenant compte de ses marges. Toutefois, vous pouvez modifier ce comportement avec les attributs et valeurs suivants. Ces attributs ne prennent effet que lorsque vous définissez la largeur d'affichage sur "correspondre aux contraintes" :
- layout_constraintWidth_min
La largeur minimale de la vue est de
dp
. - layout_constraintWidth_max
La largeur maximale de la vue est définie sur
dp
.
Toutefois, si la dimension donnée ne comporte qu'une seule contrainte, la vue s'agrandit pour s'adapter à son contenu. L'utilisation de ce mode sur la hauteur ou la largeur vous permet également de définir un ratio de taille.
- layout_constraintWidth_min
Définissez cette valeur sur true
pour permettre à la dimension horizontale de changer afin de respecter les contraintes. Par défaut, un widget défini sur WRAP_CONTENT
n'est pas limité par des contraintes.
Définir la taille en tant que ratio
![](https://developer.android.com/static/images/training/constraint-layout/constraint-layout-ratio-2x.png?authuser=6&hl=fr)
Figure 15. La vue est définie au format 16:9, et la largeur correspond à un rapport de la hauteur.
Vous pouvez définir la taille de la vue sur un format, par exemple 16:9, si au moins l'une des dimensions de la vue est définie sur "correspondre aux contraintes" (0dp
). Pour activer le ratio, cliquez sur Activer/Désactiver la contrainte de format (accroche 1 sur la figure 14), puis saisissez le ratio width:height dans l'entrée qui s'affiche.
Si la largeur et la hauteur sont toutes deux définies sur "correspondre aux contraintes", vous pouvez cliquer sur Activer/Désactiver la contrainte de format pour sélectionner la dimension basée sur la proportion de l'autre. L'inspecteur de vue indique quelle dimension est définie en tant que ratio en connectant les arêtes correspondantes par une ligne continue.
Par exemple, si vous définissez les deux côtés sur "correspondre aux contraintes", cliquez deux fois sur Activer/Désactiver la contrainte de format pour définir la largeur sur un rapport de la hauteur. La taille totale est déterminée par la hauteur de la vue, qui peut être définie de n'importe quelle manière, comme illustré dans la figure 15.
Ajuster les marges de la vue
Pour que vos vues soient espacées uniformément, cliquez sur Margin (Marge) dans la barre d'outils afin de sélectionner la marge par défaut pour chaque vue que vous ajoutez à la mise en page. Toute modification apportée à la marge par défaut ne s'applique qu'aux vues que vous ajoutez par la suite.
Vous pouvez contrôler la marge de chaque vue dans la fenêtre Attributes (Attributs) en cliquant sur le numéro de la ligne qui représente chaque contrainte. Dans la figure 14, l'accroche 4 montre que la marge inférieure est définie sur 16 dp.
Figure 16. Le bouton Margin (Marge) de la barre d'outils
Toutes les marges proposées par l'outil sont des facteurs de 8 dp pour que vos vues s'alignent sur les recommandations de grille carrée de 8 dp de Material Design.
Contrôler des groupes linéaires avec une chaîne
![](https://developer.android.com/static/training/constraint-layout/images/constraint-chain_2x.png?authuser=6&hl=fr)
Figure 17. Chaîne horizontale avec deux vues.
Une chaîne est un groupe de vues liées les unes aux autres par des contraintes de position bidirectionnelles. Les vues d'une chaîne peuvent être réparties verticalement ou horizontalement.
![](https://developer.android.com/static/training/constraint-layout/images/constraint-chain-styles_2x.png?authuser=6&hl=fr)
Figure 18. Exemples de chaque style de chaîne.
Les chaînes peuvent être stylisées de l'une des manières suivantes:
- Répartition:les vues sont réparties uniformément après la prise en compte des marges. Il s'agit de l'option par défaut.
- Réparti à l'intérieur:les première et dernière vues sont fixées aux contraintes à chaque extrémité de la chaîne, et les autres sont réparties uniformément.
- Pondéré:lorsque la chaîne est définie sur étaler ou répartir à l'intérieur, vous pouvez remplir l'espace restant en définissant une ou plusieurs vues pour qu'elles "correspondent aux contraintes" (
0dp
). Par défaut, l'espace est réparti uniformément entre chaque vue définie sur "correspondre aux contraintes", mais vous pouvez attribuer une pondération de l'importance à chaque vue à l'aide des attributslayout_constraintHorizontal_weight
etlayout_constraintVertical_weight
. Cela fonctionne de la même manière quelayout_weight
dans une mise en page linéaire : la vue avec la valeur de pondération la plus élevée obtient le plus d'espace, et les vues ayant la même pondération reçoivent le même espace. - Empaqueté:les vues sont regroupées après la prise en compte des marges. Vous pouvez ajuster le biais de toute la chaîne (à gauche ou à droite, ou en haut ou en bas) en modifiant le biais de vue "head" de la chaîne.
La vue principale de la chaîne, c'est-à-dire la vue la plus à gauche dans une chaîne horizontale (dans une mise en page de gauche à droite) et la vue la plus en haut dans une chaîne verticale, définit le style de la chaîne en XML.
Toutefois, vous pouvez basculer entre à répartition, à répartir à l'intérieur et empaqueté en sélectionnant n'importe quelle vue de la chaîne, puis en cliquant sur le bouton de chaîne qui apparaît sous la vue.
Pour créer une chaîne, procédez comme suit, comme illustré dans la vidéo 4:
- Sélectionnez toutes les vues à inclure dans la chaîne.
- Effectuez un clic droit sur l'une des vues.
- Sélectionnez Chaînes.
- Sélectionnez Centrer horizontalement ou Centrer verticalement.
Vidéo 4. Créer une chaîne horizontale
Voici quelques points à prendre en compte lorsque vous utilisez des chaînes:
- Une vue peut faire partie d'une chaîne horizontale et verticale, ce qui vous permet de créer des mises en page flexibles sous forme de grille.
- Une chaîne ne fonctionne correctement que si chacune de ses extrémités est contrainte par rapport à un autre objet du même axe, comme illustré dans la figure 14.
- Bien que l'orientation d'une chaîne soit verticale ou horizontale, l'utilisation d'une chaîne n'aligne pas les vues dans cette direction. Pour obtenir la position appropriée pour chaque vue de la chaîne, incluez d'autres contraintes, telles que des contraintes d'alignement.
Créer automatiquement des contraintes
Au lieu d'ajouter des contraintes à chaque vue lorsque vous les placez dans la mise en page, vous pouvez déplacer chaque vue aux positions de votre choix dans l'éditeur de mise en page, puis cliquer sur Infer Constraints (Contraintes inférées) pour créer automatiquement des contraintes.
Infer Constraints (Contraintes inférées) analyse la mise en page pour déterminer l'ensemble de contraintes le plus efficace pour toutes les vues. Il contraint les vues à leur position actuelle tout en offrant de la flexibilité. Vous devrez peut-être effectuer des ajustements pour que la mise en page réponde selon vos besoins en fonction de la taille et de l'orientation de l'écran.
La connexion automatique au parent est une fonctionnalité distincte que vous pouvez activer. Lorsqu'elle est activée et que vous ajoutez des vues enfants à un parent, cette fonctionnalité crée automatiquement au moins deux contraintes pour chaque vue à mesure que vous les ajoutez à la mise en page, mais uniquement lorsqu'il est approprié de limiter la vue à la mise en page parente. La connexion automatique ne crée aucune contrainte sur les autres vues de la mise en page.
La connexion automatique est désactivée par défaut. Pour l'activer, cliquez sur Enable Autoconnection to Parent (Activer la connexion automatique au parent) dans la barre d'outils de l'éditeur de mise en page.
Animations d'images clés
Dans un ConstraintLayout
, vous pouvez animer les modifications de la taille et de la position des éléments à l'aide de ConstraintSet
et TransitionManager
.
Un ConstraintSet
est un objet léger qui représente les contraintes, les marges et la marge intérieure de tous les éléments enfants d'un ConstraintLayout
. Lorsque vous appliquez un ConstraintSet
à un ConstraintLayout
affiché, la mise en page met à jour les contraintes de tous ses enfants.
Pour créer une animation à l'aide de ConstraintSet
, spécifiez deux fichiers de mise en page qui servent d'images clés de début et de fin pour l'animation. Vous pouvez ensuite charger un ConstraintSet
à partir du deuxième fichier d'image clé et l'appliquer à la ConstraintLayout
affichée.
L'exemple de code suivant montre comment animer le déplacement d'un seul bouton en bas de l'écran.
// MainActivity.kt
fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.keyframe_one)
constraintLayout = findViewById(R.id.constraint_layout) // member variable
}
fun animateToKeyframeTwo() {
val constraintSet = ConstraintSet()
constraintSet.load(this, R.layout.keyframe_two)
TransitionManager.beginDelayedTransition()
constraintSet.applyTo(constraintLayout)
}
// layout/keyframe1.xml // Keyframe 1 contains the starting position for all elements in the animation // as well as final colors and text sizes. <?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <Button android:id="@+id/button2" android:layout_width="0dp" android:layout_height="wrap_content" android:text="Button" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toTopOf="parent" /> </androidx.constraintlayout.widget.ConstraintLayout>
// layout/keyframe2.xml // Keyframe 2 contains another ConstraintLayout with the final positions. <?xml version="1.0" encoding="utf-8"?> <androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" android:layout_width="match_parent" android:layout_height="match_parent"> <Button android:id="@+id/button2" android:layout_width="0dp" android:layout_height="wrap_content" android:text="Button" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintStart_toStartOf="parent" app:layout_constraintBottom_toBottomOf="parent" /> </androidx.constraintlayout.widget.ConstraintLayout>
Ressources supplémentaires
ConstraintLayout
est utilisé dans l'application de démonstration Sunflower.