Zeigt ein Kästchen an, das aktiviert oder inaktiviert werden kann
Kategorie
Kernsteuerelemente
Syntax
<xp:checkBox attributes>Inhalt</xp:checkBox>
Tabelle 1. Wesentliche Eigenschaften| Eigenschaft |
Beschreibung |
|---|
| id |
Nimmt standardmäßig die Werte checkBox1, checkBox2 usw. an. |
| text |
Stellt eine Beschriftung zur Verfügung |
| value |
Bindet das Steuerelement an ein Datenelement oder einen anderen Wert |
| checkedValue |
Gibt den Datenwert an, wenn das Kästchen aktiviert ist. Nimmt standardmäßig die Zeichenfolge true als Wert an. |
| uncheckedValue |
Gibt den Datenwert an, wenn das Kästchen inaktiviert ist. Nimmt standardmäßig die Zeichenfolge false als Wert an. |
| defaultChecked |
Geben Sie true an, wenn das Kästchen standardmäßig aktiviert sein soll. |
Tabelle 2. Alle Eigenschaften| Kategorie |
Eigenschaften |
|---|
| Eingabehilfen |
accesskey, role, tabindex, title |
| Allgemein |
attrs, binding, dir, disabled, id, immediate, lang, loaded, readonly, rendered, rendererType, required, text |
| Daten |
checkedValue, converter, defaultChecked, disableModifiedFlag, uncheckedValue, validator, validators, value, valueChangeListener, valueChangeListeners |
| Dojo |
dojoAttributes, dojoType |
| Ereignisse |
onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup |
| Darstellung |
disableTheme, style, styleClass, themeId |
Verwendung
Zur Ausführungszeit wird ein Kontrollkästchen auf der Seite angezeigt. Der Benutzer kann dieses aktivieren oder inaktivieren. Ist das Kontrollkästchen aktiviert, wird darin ein Häkchen angezeigt.
Beispiele
Mit diesem Kontrollkästchen wird abhängig davon, ob das Kästchen aktiviert (Standardeinstellung) oder inaktiviert ist, ein Datenwert zugewiesen.
<xp:checkBox id="checkBox2" text="Use user name instead of Anonymous"
defaultChecked="true" value="#{document1.loginname}" uncheckedValue="Anonymous"
checkedValue="#{javascript:session.getUserName()}">
</xp:checkBox>
Dieses Kontrollkästchen ist an die Anforderungsvariable
phonesame gebunden. Wird das Kästchen geändert, wird ein Script ausgeführt. Mit dem Script wird der Wert des Steuerelements
phonenight (ein Editierfeld) mit dem des Steuerelements
phoneday gleichgesetzt, sobald das Kontrollkästchen aktiviert wird.
<xp:checkBox text="Night phone same as day" id="checkBox1"
value="#{requestScope.phonesame}">
<xp:eventHandler event="onchange" submit="true" refreshMode="complete">
<xp:this.action><![CDATA[#{javascript:
if(requestScope.phonesame == "true") {
getComponent("phonenight").setValue(
getComponent("phoneday").getValue());
}
}]]></xp:this.action>
</xp:eventHandler>
</xp:checkBox>