Passer au contenu principal

RadioButtonGroup

Ouvrir dans ChatGPT
23.01
Java API

Le RadioButtonGroup gère une collection de composants RadioButton. Un seul RadioButton peut être sélectionné dans un RadioButtonGroup. Lorsqu'un utilisateur coche un nouveau bouton radio, l'ancienne sélection dans le groupe est automatiquement décochée.

Afficher le code

Rendu du RadioButtonGroup

Le composant RadioButtonGroup ne rend pas un élément HTML. Il fournit uniquement la logique pour faire en sorte que les composants RadioButton se comportent en tant que groupe plutôt qu'individuellement.

Ajouter et supprimer des composants RadioButton​

Vous pouvez inclure des composants RadioButton dans le constructeur du RadioButtonGroup pour créer un groupe à partir des composants fournis. Pour ajouter ou supprimer un RadioButton d'un RadioButtonGroup existant, utilisez les méthodes add() ou remove().

Obtenir le groupe d'un RadioButton

Le composant RadioButton a la méthode getButtonGroup(), qui retourne le RadioButtonGroup auquel il appartient, ou null s'il n'a pas de groupe.

Imbriquer 25.11​

Comme d'autres composants, vous pouvez imbriquer un RadioButtonGroup dans un conteneur, afin de ne pas avoir à ajouter directement chaque RadioButton individuel.

RadioButton agree = new RadioButton("D'accord");
RadioButton neutral = new RadioButton("Neutre");
RadioButton disagree = new RadioButton("Pas d'accord");

RadioButtonGroup group = new RadioButtonGroup("choix", agree, neutral, disagree);

Fieldset fieldset = new Fieldset("Options");
fieldset.add(group);

Utiliser RadioButtonGroupChangeEvent​

Chaque RadioButton peut avoir son propre écouteur d'événements pour détecter lorsque l'utilisateur le bascule. Cependant, un avantage d'utiliser un RadioButtonGroup est que vous pouvez utiliser un seul écouteur d'événements qui répond à tous les boutons radio du groupe avec l'RadioButtonGroupChangeEvent.

Ajouter des écouteurs d'événements à chaque RadioButton

agree.onValueChange(e -> changeEvent());
neutral.onValueChange(e -> changeEvent());
disagree.onValueChange(e -> changeEvent());

Ajouter un seul écouteur d'événements au RadioButtonGroup

RadioButtonGroup group = new RadioButtonGroup("choix", agree, neutral, disagree);
group.onChange(e -> changeEvent());

L'exemple suivant provenant de Placement du tiroir utilise le RadioButtonGroupChangeEvent pour changer automatiquement le placement du composant Drawer :

Afficher le code

Nommer​

L'attribut name dans un RadioButtonGroup groupe les RadioButtons associés ensemble, permettant aux utilisateurs de faire un choix unique parmi les options fournies et imposant l'exclusivité parmi les RadioButtons. Le nom d'un groupe n'est pas reflété dans le DOM, cependant, et est un outil de commodité pour le développeur Java.