Empilement
Acteur qui permet de disposer ses acteurs enfants en les empilant, soit verticalement, soit horizontalement.
Sommaire
Propriétés
Orientation
L’empilement va disposer ses acteurs enfants suivant la règle donnée par la propriété de même Orientation :
- Verticale (par défaut) : Les acteurs enfants s’empilent les uns en dessous des autres, de haut en bas.
- Horizontale : Les acteurs enfants s’empilent les uns à côté des autres, de gauche à droite.
Disposition
Voir les règles de disposition avec les propriétés d’alignement vertical et horizontal
Dépassement de contenu
Les propriétés Dépassement vertical et Dépassement horizontal permettent de gérer le comportement de l’acteur vis à vis d’un dépassement éventuel de son contenu.
Si l’acteur dispose d’une taille figée OU est contraint par un autre élément (acteur parent par exemple), alors, les propriétés Dépassement horizontal et Dépassement vertical peuvent s’appliquer.
Il existe quatre options pour chacune de ces propriétés :
- Caché
Le contenu qui ne dispose pas de suffisamment de place pour s’afficher ne sera pas visible et ses éléments ne seront pas accessibles.
- Visible
Le contenu qui ne dispose pas de suffisamment de place est affiché en dehors de l’emplacement prévu pour l’acteur.
Attention, si un autre acteur chevauche ce dépassement, la partie qui dépasse sera cachée par cet acteur.
Il faut noter que les deux propriétés doivent être
Visibleafin d’obtenir le comportement souhaité.
- Défilement
Permet d’ajouter une scrollbar à l’acteur qui donne le moyen d’acceder au contenu qui dépassent.
- Automatique
Affiche une scrollbar uniquement s’il existe un dépassement.
⚠️ ATTENTION
Les optionsVisibleetCachéne sont pas compatibles entres elles.
La valeur par défaut est Caché
✔️ CONSEIL
Si votre contenu n’est pas visible, il y a de bonne chance que ce soit à cause de la taille réduite de l’acteur parent.
Événements
onDidActorAdd
L’évènement onDidActorAdd est déclenché lorsque un acteur est ajouté manuellement à l’acteur disposition (avec la méthode [⚡ addActor(actorSetup[,atIndex])]).
onDidActorsAdd
L’évènement onDidActorsAdd est déclenché lorsque une liste d’acteurs est ajoutée manuellement à l’acteur disposition (avec la méthode [⚡ addActors(actorSetups)]).
onDidActorRemove
L’évènement onDidActorRemove est déclenché lorsque une liste d’acteurs est ajoutée manuellement à l’acteur disposition (avec la méthode [⚡ removeActor(actorKey)]).
onDidActorsClear
L’évènement onDidActorsClear est déclenché lorsque une liste d’acteurs est ajoutée manuellement à l’acteur disposition (avec la méthode [⚡ clearActors()]).
Usage
L’empilement avec les règles de disposition flexibles sont à la base de la construction d’interface qui peuvent s’adapter à n’importe quelle taille d’écran. Associées à la disposition par Toile et la Boite à vue, ces acteurs permettent de construire n’importe quel type de gabarit.
