Overslaan naar hoofdinhoud

RadioButtonGroup

Openen in ChatGPT
23.01
Java API

De RadioButtonGroup beheert een verzameling van RadioButton componenten. Slechts één RadioButton kan geselecteerd worden in een RadioButtonGroup. Wanneer een gebruiker een nieuwe radio button aanvinkt, wordt de eerder geselecteerde automatisch uitgeschakeld.

Toon Code

RadioButtonGroup renderen

De RadioButtonGroup component rendert geen HTML-element. Het biedt alleen logica om RadioButton componenten zich als een groep te laten gedragen in plaats van individueel.

Toevoegen en verwijderen van RadioButton componenten​

Je kunt RadioButton componenten opnemen in de RadioButtonGroup constructor om een groep te maken uit de opgegeven componenten. Om een RadioButton toe te voegen of te verwijderen uit een bestaande RadioButtonGroup, gebruik je de add() of remove() methoden.

Het verkrijgen van de Groep van een RadioButton

De RadioButton component heeft de getButtonGroup() methode, die de RadioButtonGroup retourneert waartoe het behoort, of null als het geen groep heeft.

Nesten 25.11​

Net als andere componenten, kun je een RadioButtonGroup binnen een container nestelen, zodat je niet elke individuele RadioButton direct hoeft toe te voegen.

RadioButton agree = new RadioButton("Akkoord");
RadioButton neutral = new RadioButton("Neutraal");
RadioButton disagree = new RadioButton("Niet akkoord");

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

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

Gebruik van RadioButtonGroupChangeEvent​

Elke RadioButton kan zijn eigen gebeurtenisluisteraar hebben om te detecteren wanneer een gebruiker deze schakelt. Echter, een voordeel van het gebruiken van een RadioButtonGroup is dat je een enkele gebeurtenisluisteraar kunt gebruiken die reageert op alle radio buttons in de groep met de RadioButtonGroupChangeEvent.

Toevoegen van gebeurtenisluisteraars aan elke RadioButton

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

Toevoegen van een enkele gebeurtenisluisteraar aan de RadioButtonGroup

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

Het volgende voorbeeld van Drawer Plaatsing gebruikt de RadioButtonGroupChangeEvent om automatisch de plaatsing van de Drawer component te wijzigen:

Toon Code

Naamgeving​

De name attribuut in een RadioButtonGroup groepeert gerelateerde RadioButtons samen, waardoor gebruikers een enkele keuze kunnen maken uit de beschikbare opties en exclusiviteit onder de RadioButtons afdwingen. De naam van een groep wordt echter niet weerspiegeld in de DOM en is een handige utility voor de Java-ontwikkelaar.