Checkbox (SP-Tag)

Aus SiteparkWiki
(Weitergeleitet von Sp:checkbox)
Zur Navigation springen Zur Suche springen

Name

<sp:checkbox> - erzeugt eine Checkbox

Syntax

<sp:checkbox name="variable" value="Inhalt"/>

Beschreibung

Der Checkbox-Tag erzeugt eine HTML-Checkbox.

Attribute

Name Type Required Default ab IES Version
name Variable Ja None 1
value Text Nein None 1
locale Locale Nein None 1
type Content-Type Nein text 1
checked Condition Nein None 1
disabled Condition Nein None 1
readonly Condition Nein None 1
Dynamische Attribute Text Nein None 1
name
Bestimmt den Namen des Feldes.
value
Setzt einen zu übertragenen Wert dieser Checkbox
locale
Dieses Attribut bestimmt die Mehrsprachigkeit der Variablen.
type
Der Typ des Eingabefeldes.
checked
Gibt an, ob der Radio-Button per default gechecked werden soll. Diese Einstellung gibt es nur so lange, bis eine Auswahl durch den Bearbeiter vorgenommen und gespeichert wurde.
disabled
HTML-Attribut (true, false).
readonly
HTML-Attribut (true, false).
Dynamische Attribute
Dynamische Attribute sind beliebige HTML-Attribute, die evaluiert und bis zum HTML-Tag durchgereicht werden.

Beispiele

Checkboxen mit Label

Template Quelltext

Wählen Sie aus<br>
<sp:checkbox name="check_food" value="Wurst"/> <label for="<sp:print name="system.tag"/>">Wurst</label><br>
<sp:checkbox name="check_food" value="Käse"/> <label for="<sp:print name="system.tag"/>">Käse</label><br>
<sp:checkbox name="check_food" value="Milch"/> <label for="<sp:print name="system.tag"/>">Milch</label><br>

Mit <sp:print name="system.tag"/> wird die interne id des vorangegangenen SP-Tags ermittelt und ausgegeben.

Checkboxen mit dynamischem Attribut "id" und Label

Template Quelltext

Wählen Sie aus<br>
<table>
  <tr>
    <td><label for="wurst">Wurst</label></td>
    <td><sp:checkbox name="check_food" value="Wurst" id="wurst"/></td>
  </tr>
  <tr>
    <td><label for="kaese">Käse</label></td>
    <td><sp:checkbox name="check_food" value="Käse" id="kaese"/></td>
  </tr>
  <tr>
    <td><label for="milch">Milch</label></td>
    <td><sp:checkbox name="check_food" value="Milch" id="milch"/></td>
  </tr>
</table>

Für den Fall, dass ein Label vor dem zugehörigen SP-Tag ausgegeben werden soll, kann für die Checkbox eine eigene id vergeben werden. Zu beachten ist hierbei jedoch, dass die id innerhalb eines HTML-Seite eindeutig sein muss. Bei Iterates sollte daher noch ein Zähler in die id einbezogen werden.