Zum Hauptinhalt springen

RadioButtonGroup

In ChatGPT öffnen
23.01
Java API

Die RadioButtonGroup verwaltet eine Sammlung von RadioButton Komponenten. Es kann nur ein RadioButton in einer RadioButtonGroup ausgewählt werden. Wenn ein Benutzer einen neuen Radiobutton aktiviert, wird der zuvor in der Gruppe ausgewählte automatisch deaktiviert.

Erstellung einer RadioButtonGroup​

Rendering der RadioButtonGroup

Die RadioButtonGroup Komponente rendert kein HTML-Element. Sie bietet lediglich die Logik, damit RadioButton Komponenten sich als Gruppe und nicht individuell verhalten.

Erstellen Sie einzelne RadioButton Komponenten und übergeben Sie diese an den Konstruktor der RadioButtonGroup. In der Gruppe kann jeweils nur ein Button ausgewählt werden.

Code anzeigen

Hinzufügen und Entfernen von RadioButton Komponenten​

Sie können RadioButton Komponenten im Konstruktor der RadioButtonGroup einfügen, um eine Gruppe aus den bereitgestellten Komponenten zu erstellen. Um einen RadioButton aus einer bestehenden RadioButtonGroup hinzuzufügen oder zu entfernen, verwenden Sie die Methoden add() oder remove().

Abrufen der Gruppe eines RadioButton

Die RadioButton Komponente hat die Methode getButtonGroup(), die die RadioButtonGroup zurückgibt, zu der sie gehört, oder null, wenn sie keine Gruppe hat.

Verschachtelung 25.11​

Wie bei anderen Komponenten können Sie eine RadioButtonGroup innerhalb eines Containers verschachteln, sodass Sie nicht jeden einzelnen RadioButton direkt hinzufügen müssen.

RadioButton agree = new RadioButton("Zustimmen");
RadioButton neutral = new RadioButton("Neutral");
RadioButton disagree = new RadioButton("Ablehnen");

RadioButtonGroup group = new RadioButtonGroup("Auswahlmöglichkeiten", agree, neutral, disagree);

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

Verwendung von RadioButtonGroupChangeEvent​

Jeder RadioButton kann seinen eigenen Ereignislistener haben, um zu erkennen, wann ein Benutzer ihn umschaltet. Ein Vorteil der Verwendung einer RadioButtonGroup besteht jedoch darin, dass Sie einen einzigen Ereignislistener verwenden können, der auf alle Radiobuttons in der Gruppe mit dem RadioButtonGroupChangeEvent reagiert.

Ereignislistener zu jedem RadioButton hinzufügen

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

Einen einzelnen Ereignislistener zur RadioButtonGroup hinzufügen

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

Das folgende Beispiel aus Drawer Placement verwendet das RadioButtonGroupChangeEvent, um die Platzierung der Drawer Komponente automatisch zu ändern:

Code anzeigen

Benennung​

Das name Attribut in einer RadioButtonGroup gruppiert verwandte RadioButtons und ermöglicht es Benutzern, eine einzige Wahl aus den angebotenen Optionen zu treffen und Exklusivität unter den RadioButtons durchzusetzen. Der Name einer Gruppe wird jedoch nicht im DOM widergespiegelt, sondern ist ein praktisches Hilfsmittel für den Java-Entwickler.