Toggle (SP-Tag)
Version vom 16. Januar 2024, 18:46 Uhr von Schleusner (Diskussion | Beiträge)
Name
<sp:toggle> - erzeugt eine Toggle-Checkbox
Syntax
<sp:toggle name="variable"/>
Beschreibung
Der Toggle-Tag erzeugt eine HTML-Checkbox, die nur boolesche Werte verarbeiten kann
Attribute
| Name | Type | Required | Default | ab IES Version |
|---|---|---|---|---|
name
|
Variable | Ja | None | 1 |
value
|
Text | Nein | None | 1 |
fixvalue
|
Text | Nein | None | 1 |
locale
|
Locale | Nein | None | 1 |
type
|
Content-Type | Nein | text | 1 |
disabled
|
Condition | Nein | None | 1 |
readonly
|
Condition | Nein | None | 1 |
onValue
|
Condition | Nein | true
|
3.15.0 |
offValue
|
Condition | Nein | false
|
3.15.0 |
| Dynamische Attribute | Text | Nein | None | 1 |
name- Bestimmt den Namen des Feldes.
value- Setzt einen Default-Wert für die mit
nameangegebenen Variable, wenn sie leer ist.
fixvalue- Überschreibt jeden vorhandenen Inhalt der mit
namebestimmten Variablen mit dem durchfixvalueangegebenen Wert.
locale- Dieses Attribut bestimmt die Mehrsprachigkeit der Variablen.
type- Der Typ des Eingabefeldes.
disabled- HTML-Attribut (true, false).
readonly- HTML-Attribut (true, false).
onValue- Wert der gesetzt wird, wenn die Checkbox gechecked ist
offValue- Wert der gesetzt wird, wenn die Checkbox nicht gechecked ist
- Dynamische Attribute
- Dynamische Attribute sind beliebige HTML-Attribute, die evaluiert und bis zum HTML-Tag durchgereicht werden.
Beispiele
<%-- Renders a unchecked checkbox, storing `false` when unchecked and `true` when checked --%>
<sp:toggle name="sp_toggle" />
<%-- Renders a unchecked checkbox, storing `true` when unchecked and `false` when checked --%>
<sp:toggle name="sp_toggle" offValue="true" onValue="false" />
<%-- Renders a checked checkbox, storing `true` when unchecked and `false` when checked --%>
<sp:toggle name="sp_toggle" value="false" offValue="true" onValue="false" />