X4 Produktdokumentation

RadioButtonGroup

Mit <RadioButtonGroup>-Controls können Sie eine Gruppe von Radio-Buttons erzeugen, die in einer einzigen Zelle enthalten sind. Benutzer können eine Auswahl aus mehreren vordefinierten Optionen treffen, bei der immer nur eine Option aktiv sein kann. Sie eignen sich insbesondere für Entscheidungen, bei denen sich die Auswahlmöglichkeiten gegenseitig ausschließen, wie etwa die Auswahl einer Zahlungsart oder eines Prioritätslevels.

Hinweise zur Verwendung

Ein <RadioButtonGroup>-Control wird mit dem Element <RadioButtonGroup> erzeugt. Das Element kann nur im Layout einer Detail Component oder einer Form Component verwendet werden.

<RadioButtonGroup>
...
</RadioButtonGroup>

Das Element <RadioButtonGroup> kann folgendes Element enthalten:

  • <RadioButtonOption>

<RadioButtonGroup>-Controls können in allen verfügbaren Layouttypen verwendet werden. Weitere Informationen finden Sie unter Layouts.

Attribute

Hinweis:

Es gibt eine Reihe von Standardattributen, die für alle Controls festgelegt werden können. Weitere Informationen zu den Standardattributen finden Sie unter Standardattribute.

Zusätzlich zu den Standardattributen können Sie das folgende Attribut für <RadioButtonGroup>-Controls definieren:

Attribut

Beschreibung

value

Erforderlich

Technischer Wert, der weiterverarbeitet werden soll.

  • Data Binding (String oder Boolean) möglich

Mögliche Werte:

Beliebige Zeichenkette

Element <RadioButtonOption>

Kindelement von <RadioButtonGroup>. Definiert die einzelnen Optionen für die Radio-Button-Gruppe.

Sie können folgende Attribute für das Element <RadioButtonOption> definieren:

Attribut

Beschreibung

value

Erforderlich

Technischer Wert, der weiterverarbeitet werden soll.

  • Data Binding (String oder Boolean) möglich

Mögliche Werte:

Beliebige Zeichenkette

displayName

Beschriftung des Radio-Buttons.

  • Übersetzbar

  • Data Binding möglich

Mögliche Werte:

Beliebige Zeichenkette

Actions

Für <RadioButtonGroup>-Controls steht Ihnen folgende Action zur Verfügung. Weitere Informationen zu Actions finden Sie unter Actions.

<SelectAction> 

Sie können die Action Select über das Element <SelectAction/> innerhalb von <RadioButtonGroup> einfügen. Die Action wird ausgelöst, sobald der Benutzer den Radio-Button auswählt.

Hinweis:

Sie müssen das Element <SelectAction> vor dem gewünschten Layouttyp (BoxLayoutFlowLayout, GridLayoutResponsiveLayoutTabLayout) einfügen.

Die Aktion Auswählen wird über das Element <SelectAction/> innerhalb von <RadioButtonGroup> erzeugt und ausgelöst, sobald dieser ausgewählt wurde.

Beispiel

RadioButton-Control in der Detail Component
XML
<DetailComponent>
    <FlowLayout>
        <Label value="Select your preferred appointment type" fontWeight="Bold"/>
        <RadioButtonGroup value="#appointment" horizontalAlign="left">
            <RadioButtonOption value="#appointment" displayName="On-site"/>
            <RadioButtonOption value="#appointment" displayName="Phone"/>
            <RadioButtonOption value="#appointment" displayName="Video call"/>
        </RadioButtonGroup>
    </FlowLayout>
</DetailComponent>
image-20251124-124712.png