30.5. <w:checkBox>

checkBox选择框。

30.5.1. 构件信息

表 30.10. 构件信息

Component Type	org.operamasks.faces.component.form.impl.UICheckBox
Component Family	javax.faces.Input
Component Class	org.operamasks.faces.component.form.impl.UICheckBox
Tag Class	org.operamasks.faces.webapp.form.UICheckBoxTag
Renderer Type	org.operamasks.faces.component.form.impl.UICheckBox
Renderer Class	org.operamasks.faces.render.widget.ajax.AjaxCheckBoxRenderer

继承体系

+java.lang.Object

++javax.faces.component.UIComponent

+++javax.faces.component.UIComponentBase

++++javax.faces.component.UIOutput

+++++javax.faces.component.UIInput

++++++org.operamasks.faces.component.form.base.UIFieldBase

+++++++org.operamasks.faces.component.form.impl.UIField

++++++++org.operamasks.faces.component.form.base.UICheckBoxBase

+++++++++org.operamasks.faces.component.form.impl.UICheckBox

30.5.2. 属性

表 30.11. 属性

alwaysSubmit	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(boolean)
	是否必须	否	延时求值	是
	构件是否总是提交，与readOnly，disabled属性结合使用。当一个输入组件的readOnly或disabled设为true时，它的值无法提交到后台。但如果同时将alwaysSubmit设为true，则它的值可以提交到后台
binding	定义类	javax.faces.component.UIComponentBase
	类型	javax.el.ValueExpression(javax.faces.component.UIComponent)
	是否必须	否	延时求值	是
	一个值表达式，用于把该组件链接到一个ManagedBean的某个属性。
boxLabel	定义类	org.operamasks.faces.component.form.impl.UICheckBox
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	checkbox旁边显示的文本
checked	定义类	org.operamasks.faces.component.form.base.UICheckBoxBase
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件的状态是否为已选中(默认值：false)
clientValidate	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件是否进行客户端校验
cls	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的css样式类名
converter	定义类	javax.faces.component.UIOutput
	类型	java.lang.String
	是否必须	否	延时求值	否
	构件注册的转换器
converterMessage	定义类	javax.faces.component.UIInput
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件中值转换失败时，构件的提示信息
disabled	定义类	org.operamasks.faces.component.form.base.UIFieldBase
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件是否设置为disabled(默认值：false)，disabled属性设置为true后，需设置alwaysSubmit="true"，页面值才会提交
fieldClass	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	field的默认样式(默认值："x-form-field")
fieldLabel	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的label
focusClass	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	当field收到焦点时的样式(默认值："x-form-focus")
height	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	构件的高度，以象素为单位。
hidden	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件是否可见。
hideLabel	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否完全隐藏构件的label(默认值：false)
id	定义类	javax.faces.component.UIComponentBase
	类型	java.lang.String
	是否必须	否	延时求值	否
	这个组件的组件标识符。这个值在最近的命名容器类型的父组件范围内，必须是唯一的。
immediate	定义类	javax.faces.component.UIInput
	类型	javax.el.ValueExpression(boolean)
	是否必须	否	延时求值	是
	如果该属性设置为true，该构件的校验和转换就会在应用请求值阶段进行，反之，在处理验证阶段执行
initConfig	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	初始化对象，取值可以是ExtConfig对象, 或String，表示一个JavaScript对象，比如:{"a": "avalue", "b":true, "c":200, "d":"var::dvalue"} 如果取值是表示一个JavaScript对象的String，则key必须用(双）引号包起来，比如"a"。
inputValue	定义类	org.operamasks.faces.component.form.impl.UICheckBox
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	生成的input元素的value属性的值
jsvar	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	客户端脚本使用的javascript变量名，使用此变量名可以在客户端脚本中引用构件对应的客户端对象
labelSeparator	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	显示在label后面的分隔符(默认值：':')。
labelStyle	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	field的label的CSS样式(默认值：如果设置了父容器的labelStyle就使用父容器的labelStyle，否则为'')
msgTarget	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	错误信息文本的显示位置
onblur	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onblur事件发生(构件失去输入焦点时触发)时执行的JavaScript代码
onchange	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onchange事件发生(内容改变时触发)时执行的JavaScript代码
oncheck	定义类	org.operamasks.faces.component.form.impl.UICheckBox
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的oncheck事件发生(构件选中时触发)时执行的JavaScript代码
ondisable	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的ondisable事件发生(构件变为无效时触发)时执行的JavaScript代码
onenable	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onenable事件发生(构件变为有效时触发)时执行的JavaScript代码
onfocus	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onfocus事件发生(构件获取焦点时触发)时执行的JavaScript代码
onhide	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onhide事件发生(构件隐藏时触发)时执行的JavaScript代码
onkeydown	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onkeydown事件发生(键盘按下时触发)时执行的JavaScript代码
onkeypress	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onkeypress事件发生(键盘按下时触发)时执行的JavaScript代码
onkeyup	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onkeyup事件发生(键盘抬起时触发)时执行的JavaScript代码
onshow	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onshow事件发生(构件显示时触发)时执行的JavaScript代码
readOnly	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否在HTML中将field标识为readOnly(默认值：false)，readOnly属性设置为true后，需设置alwaysSubmit="true"，页面值才会提交。此属性暂不支持w:simpleHtmlEditor、w:radioGroup、w:checkBoxGroup
rendered	定义类	javax.faces.component.UIComponentBase
	类型	boolean(boolean)
	是否必须	否	延时求值	是
	一个标志，指出该组件是否要在任何随后的form提交过程中被渲染或处理。这个属性的缺省值是true。
style	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件渲染后最外层DOM元素的样式。
styleClass	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件渲染后最外层DOM元素的样式类名。若有多个，以空格分隔。
tabIndex	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	当用户使用tab键时页面上构件获得焦点的顺序索引
tooltip	定义类	org.operamasks.faces.component.form.base.UIFieldBase
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	鼠标经过时的弹出信息。
validateEvents	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件客户端校验发生的时机
validator	定义类	javax.faces.component.UIInput
	类型	javax.el.MethodExpression(javax.el.MethodExpression)
	是否必须	否	延时求值	是
	指定一个校验器id或用EL表达式指定一个校验方法。引擎使用该校验器对用户输入进行有效性校验
validatorMessage	定义类	javax.faces.component.UIInput
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	校验失败时的提示信息
value	定义类	javax.faces.component.UIInput
	类型	java.lang.String
	是否必须	否	延时求值	否
	构件的当前值
valueChangeListener	定义类	javax.faces.component.UIInput
	类型	javax.el.MethodExpression(javax.el.MethodExpression)
	是否必须	否	延时求值	是
	该属性为一个EL表达式（MethodBinding），表示当值改变时响应事件的方法。表达式所指定的方法必须是void valueChange(javax.faces.event.ValueChangeEvent)形式
width	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Integer)
	是否必须	否	延时求值	是
	构件的宽度，以象素为单位。

30.5.3. 构件API

30.5.3.1. UIField(Field构件公共基类)

表 30.12. 常用方法

enable	方法签名	public void enable()
	参数说明	无参数
	返回值	无返回值
	方法描述	将构件设置为可用。
disable	方法签名	public void disable()
	参数说明	无参数
	返回值	无返回值
	方法描述	将构件设置为不可用。
show	方法签名	public void show()
	参数说明	无参数
	返回值	无返回值
	方法描述	显示构件。
hide	方法签名	public void hide()
	参数说明	无参数
	返回值	无返回值
	方法描述	隐藏构件。
focus	方法签名	public void focus()
	参数说明	无参数
	返回值	无返回值
	方法描述	当前构件获得焦点。

30.5.4. 示例

下面的例子是一个很简单的checkBox，当选中一个框的时候，会触发onclick事件，到后台去计算勾中了那些框，并把结果打印出来

<w:form> 
  <w:checkBox id="red" boxLabel="红色"/> 
  <w:checkBox id="blue" boxLabel="蓝色"/> 
  <w:checkBox id="green" boxLabel="绿色"/> <br/> 
  <h:outputText id="response" escape="false">
  </h:outputText> 
</w:form>

上一页	起始页	下一页
30.4. <w:calendar>		30.6. <w:checkBoxGroup>