Checkbox | X4Documentation

Mit <Checkbox>-Controls können Sie einfache Ja/Nein-Entscheidungen oder Mehrfachauswahlen in Formularen abbilden. Benutzer können einzelne Optionen aktivieren oder mehrere Auswahlmöglichkeiten gleichzeitig treffen. Darüber hinaus lassen sich <Checkbox>-Controls einsetzen, um die Sichtbarkeit oder Aktivierung anderer Formularfelder zu steuern oder bestimmte Prozesspfade im Workflow auszulösen.

Hinweise zur Verwendung

Ein <Checkbox>-Control wird mit dem Element <Checkbox> erzeugt.

<Checkbox>
...
</Checkbox>

<Checkbox>-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 die folgenden Attribute für <Checkbox>-Controls definieren:

Attribut	Beschreibung
`checked`	Erforderlich Gibt an, ob die Checkbox standardmäßig aktiviert oder deaktiviert ist. Data Binding (Boolean) möglich Hinweis: Die Verwendung von Data Binding für den Status der Checkbox ist notwendig, damit die Checkbox ordnungsgemäß funktioniert und den initialen Wert von `result` bzw. `set` zu speichern. Mögliche Werte: `true` / `false` Zeichenkette für Data Binding
`displayName`	Beschriftung. Wird neben der Checkbox angezeigt. Data Binding möglich Mögliche Werte: Beliebige Zeichenkette
`sliderOnDesktop`	Legt fest, ob die Checkbox in der Desktopversion als Schieberegler angezeigt wird. Mögliche Werte: `true` / `false`

Attribut

Beschreibung

checked

Erforderlich

Gibt an, ob die Checkbox standardmäßig aktiviert oder deaktiviert ist.

Data Binding (Boolean) möglich

Hinweis:

Die Verwendung von Data Binding für den Status der Checkbox ist notwendig, damit die Checkbox ordnungsgemäß funktioniert und den initialen Wert von result bzw. set zu speichern.

Mögliche Werte:

true / false
Zeichenkette für Data Binding

displayName

Beschriftung. Wird neben der Checkbox angezeigt.

Data Binding möglich

Mögliche Werte:

Beliebige Zeichenkette

sliderOnDesktop

Legt fest, ob die Checkbox in der Desktopversion als Schieberegler angezeigt wird.

Mögliche Werte:

true / false

Hinweis:

Checkboxen werden in der Desktop-Version und in der mobilen Version unterschiedlich angezeigt.

Anzeige in der Desktop-Version:
Anzeige in der mobilen Version:

Mit dem Attribut sliderOnDesktop kann die Anzeige für die mobile Version auch in der Desktop-Version angezeigt werden.

Actions

Für <Checkbox>-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 <Checkbox> einfügen. Die Action wird ausgelöst, sobald der Benutzer die Checkbox aktiviert oder deaktiviert.

Hinweis:

Sie müssen das Element <SelectAction> vor dem gewünschten Layouttyp (BoxLayout, FlowLayout, GridLayout, ResponsiveLayout, TabLayout) einfügen.

Beispiel

Checkbox-Control in der Detail Component

XML

<DetailComponent>
    <FlowLayout horizontalAlign="left">
        <Checkbox checked="#checkNews" displayName="Subscribe to newsletter" fontSize="large"/>
        <Checkbox checked="true" displayName="I accept the privacy policy" textOverflow="allow" foreground="A700" fontSize="large"/>
    </FlowLayout>
</DetailComponent>