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
name
angegebenen Variable, wenn sie leer ist.
fixvalue
- Überschreibt jeden vorhandenen Inhalt der mit
name
bestimmten Variablen mit dem durchfixvalue
angegebenen 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" />