Passer au contenu principal

RadioButtonGroup

Ouvrir dans ChatGPT
23.01
Java API

Le RadioButtonGroup gère une collection de RadioButton composants. Un seul RadioButton peut être sélectionné dans un RadioButtonGroup. Lorsque l'utilisateur coche un nouveau bouton radio, celui précédemment sélectionné dans le groupe est automatiquement décoché.

Création d'un RadioButtonGroup​

Rendu du RadioButtonGroup

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

Créez des composants RadioButton individuels et passez-les au constructeur du RadioButtonGroup. Un seul bouton dans le groupe peut être sélectionné à la fois.

Afficher le code

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 dispose de la méthode getButtonGroup(), qui renvoie le RadioButtonGroup auquel il appartient, ou null s'il n'a pas de groupe.

Imbrication 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("Accepter");
RadioButton neutral = new RadioButton("Neutre");
RadioButton disagree = new RadioButton("Ne pas accepter");

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

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

Utilisation de RadioButtonGroupChangeEvent​

Chaque RadioButton peut avoir son propre écouteur d'événements pour détecter lorsqu'un 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 dans le groupe avec le RadioButtonGroupChangeEvent.

Ajout d'écouteurs d'événements à chaque RadioButton

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

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

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

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

Afficher le code

Nommer​

L'attribut name dans un RadioButtonGroup regroupe des RadioButtons liés, permettant aux utilisateurs de faire un seul choix parmi les options fournies et en renforçant l'exclusivité parmi les RadioButtons. Le nom d'un groupe n'est pas reflété dans le DOM, cependant, et est un utilitaire pratique pour le développeur Java.