Toggle (SP-Tag)

Aus SiteparkWiki
Version vom 16. Januar 2024, 18:46 Uhr von Schleusner (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

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 durch fixvalue 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" />