checkBox - 勾選框

顯示可選取或清除的方框。

種類

核心控制項

語法

<xp:checkBox attributes>content</xp:checkBox>

表 1. 重要內容
內容	說明
id	預設值為 `checkBox1`、`checkBox2` 等等。
text	提供標籤。
value	將控制項連結到資料元素或其他值。
checkedValue	指定當選取方框時的資料值。預設值為字串 `true`。
uncheckedValue	指定當清除方框時的資料值。預設值為字串 `false`。
defaultChecked	指定 `true` 可依預設選取方框。

表 2. 所有內容
種類	內容
協助工具	accesskey、role、tabindex、title
基本	attrs、binding、dir、disabled、id、immediate、lang、loaded、readonly、rendered、rendererType、required、text
資料	checkedValue、converter、defaultChecked、disableModifiedFlag、uncheckedValue、validator、validators、value、valueChangeListener、valueChangeListeners
dojo	dojoAttributes、dojoType
事件	onblur、onchange、onclick、ondblclick、onfocus、onkeydown、onkeypress、onkeyup、onmousedown、onmousemove、onmouseout、onmouseover、onmouseup
樣式	disableTheme、style、styleClass、themeId

用法

在執行時期，頁面上會出現勾選框。使用者可以選取或清除它。在選取時方框中會出現勾號。

範例

此「勾選框」控制項會根據選取（預設）還是清除方框來指派資料值。

<xp:checkBox id="checkBox2" text="Use user name instead of Anonymous"
	defaultChecked="true" value="#{document1.loginname}" uncheckedValue="Anonymous"
	checkedValue="#{javascript:session.getUserName()}">
</xp:checkBox>

這個「勾選框」控制項連結到名為 phonesame 的要求變數。若方框已變更，則會執行 Script。如果選取了勾選框，Script 會將 phonenight 控制項（編輯框）的值設為等於 phoneday 控制項。

<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>