OOUI/Elements/Groups/fr

Tout widget OOUI contenant d'autres widgets (tels que les boutons, les options, les champs de saisie, les outils, etc.) mixe dans. Ajouter, supprimer, et réiniitaliser des éléments se fait via ce que l'interface  propose.

SelectWidgets contient des options exclusives; il présente des exemples communs d'une classe qui réalise des mixages dans. est utilisé lorsque les boutons sont groupés logiquement et qu'ils ne sont pas mutuellement exclusifs; c'est un autre exemple. est aussi un autre exemple.

Tous les éléments d'un groupe sont adressés à l'aide d'une référence unique. Si un élément est ajouté dans un groupe où il y a déjà un élément qui porte la même référence, ce dernier sera retiré et le nouvel élément sera ajouté à la fin du tableau des éléments.

L'exemple suivant montre un  contenant deux boutons. Notez que les boutons sont créés mais ne sont pas ajoutés au DOM. Par contre ils sont ajoutés dans le groupe de boutons en utilisant l'option de configuration  du widget. La liste complète des méthodes prises en charge ainsi que les options de configuration, sont décrites dans la documentation du code de.



La classe mixin  contient plusieurs méthodes pouvant être utilisées pour ajouter, supprimer, ou effacer les widgets d'un groupe. Pour avoir la liste complète des méthodes reconnues, voir la pour  .



Agréger des événements
Vous pouvez invoquer la méthode  de GroupElement pour lui demander de capter l'événement que vous spécifiez en écoutant sur tous les éléments qu'il contient, et d'émettre un nouvel événement   en réponse. Par exemple le ToolGroup utilise cela pour se désactiver lorsque tous les éléments qu'il contient sont désactivés. D'une manière similaire, un élément de groupe que vous pouvez faire glisser écoute les déplacements de chacun de ses éléments et émet un événement de synthèse pour réordonner les fils.