30.57. <w:simpleHtmlEditor>

simpleHtmlEditor构件是一个html编辑器，提供比较丰富的文本编辑功能。

30.57.1. 构件信息

表 30.137. 构件信息

Component Type	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
Component Family	javax.faces.Input
Component Class	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
Tag Class	org.operamasks.faces.webapp.form.UISimpleHtmlEditorTag
Renderer Type	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
Renderer Class(AJAX)	org.operamasks.faces.render.widget.ajax.AjaxSimpleHtmlEditorRenderer

继承体系

+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.UISimpleHtmlEditorBase

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

30.57.2. 属性

表 30.138. 属性

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的某个属性。
clientValidate	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件是否进行客户端校验
converter	定义类	javax.faces.component.UIOutput
	类型	java.lang.String
	是否必须	否	延时求值	否
	构件注册的转换器
converterMessage	定义类	javax.faces.component.UIInput
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件中值转换失败时，构件的提示信息
enableAlignments	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件的对齐方式按钮是否可用(默认可用)
enableColors	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件的颜色按钮是否可用(默认可用)
enableFont	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许选择字体(默认允许)
enableFontSize	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件的字号的增大/减小按钮是否可用(默认可用)
enableFormat	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	构件的font style选择按钮是否可用(默认可用)
enableLinks	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许添加链接(默认允许)
enableLists	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许使用bullet and numbered list按钮(默认允许)
enableSourceEdit	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.Boolean)
	是否必须	否	延时求值	是
	是否允许使用源码编辑(默认允许)
fieldLabel	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的label
fontFamilies	定义类	org.operamasks.faces.component.form.impl.UISimpleHtmlEditor
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	允许选择的font families
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"。
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)
	是否必须	否	延时求值	是
	错误信息文本的显示位置
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代码
onhide	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onhide事件发生(构件隐藏时触发)时执行的JavaScript代码
onshow	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	构件的onshow事件发生(构件显示时触发)时执行的JavaScript代码
rendered	定义类	javax.faces.component.UIComponentBase
	类型	boolean(boolean)
	是否必须	否	延时求值	是
	一个标志，指出该组件是否要在任何随后的form提交过程中被渲染或处理。这个属性的缺省值是true。
required	定义类	javax.faces.component.UIInput
	类型	javax.el.ValueExpression(boolean)
	是否必须	否	延时求值	是
	构件是否不允许提交空值
requiredMessage	定义类	javax.faces.component.UIInput
	类型	javax.el.ValueExpression(java.lang.String)
	是否必须	否	延时求值	是
	当requried属性为真，构件如果提交了空值导致校验失败时构件的提示信息
requiredTrim	定义类	org.operamasks.faces.component.form.impl.UIField
	类型	javax.el.ValueExpression(boolean)
	是否必须	否	延时求值	是
	构件进行required校验时是否将输入的值作trim操作后校验
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键时页面上构件获得焦点的顺序索引
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.57.3. 构件API

30.57.4. 示例

下面的例子是一个很简单的simpleHtmlEditor，通过width="600" height="100"指定其宽、高：

<w:form> 
  <w:simpleHtmlEditor id="message" width="600" height="100" /> 
  <w:button id="click" value="Button" /> 
  <h:outputText id="response" escape="false"></h:outputText> 
</w:form>

上一页	起始页	下一页
30.56. <w:simpleDataGrid>		30.58. <w:slider>