在使用可视设计器编辑的某个页面上选择文本区域组件
时,将显示该组件的“属性”窗口。
文本区域组件的大多数属性既是 JSP 属性,又是页面 Bean 中 TextArea Java 组件的属性。
此 JavaServer Faces 1.2 组件具有以下属性。
类型:字符串类型:整型label 属性,则可以使用 columns 属性来设置组件的宽度。否则,如果 label 属性为空,则可以使用 style 或 styleClass 属性来覆盖 columns 属性。还可以拖动大小调整句柄,以便在 style 属性中设置组件的高度和宽度。类型:字符串label 属性不像标签组件那样灵活。如果要对标签的外观进行更多控制(如相对于组件定位标签),则可以使用标签组件。类型:整型类型:整型style 或 styleClass 属性中明确设置高度,此属性将决定组件的高度。如果未设置 label 属性,style 或 styleClass 属性设置将覆盖 rows 属性。拖动大小调整句柄,可以在 style 属性中设置组件的高度和宽度。
style 属性中设置 height。例如,height: 100; 即高度设置为 100 像素。类型:字符串有关 CSS2 样式属性的列表,请参见以下 Web 页:
类型:字符串style 属性描述。 类型:对象类型:转换器text 属性生成正确类型值的 JavaServer Faces 转换器。如果用户输入了错误类型的值(如为整型转换器输入词语而不是数值),转换器将发送一条可以在消息组件中显示的消息。组件将为 text 属性选择正确的转换器(如果可用),从而不必在大多数情况下都设置此属性。如果与 text 属性绑定的值的类型未列在转换器列表中,则必须提供您自己的转换器,并设置此属性。
enum 类作为参数(如枚举转换器中所述)。类型:布尔型for 属性链接到此组件,则当用户尝试在不输入值的情况下提交页面时,屏幕将显示一条错误消息。类型:方法表达式可以从下拉列表中选择一个验证器。如果选择 (null),则不会调用任何验证器。如果选择了验证器,则还需要选择 required 属性以确保用户输入值。
要设置事件属性,请在可视设计器中右键单击组件,然后选择“编辑事件处理程序”> "<事件名称>"。
component-id_processValueChange,其中 component-id 是 id 属性的值。如果要编写 validate 方法代码,而不是为 validatorExpression 属性选择 JavaServer Faces 验证器,请右键单击该组件,然后选择“编辑事件处理程序”> "validate"。该方法的缺省名称为 component-id_validate,其中 component-id 是组件的 id 属性的值。按照这种方式定义该方法时,将自动设置 validator 和 validate 属性。如果定义了验证器,则还需要选择 required 属性以确保用户输入值。
validatorExpression 属性的值。如果定义您自己的 validate 方法,请不要单独更改 validatorExpression 属性的值,否则会断开 validate 方法连接。类型:长整型类型:布尔型autoValidate 时,还会将 ajaxify 属性设置为 true。此外,如果设置 autoValidate,则必须提供此组件的验证器。(如果设置了该属性,但没有验证器,会发生什么情况呢?)有关提供验证器的详细信息,请参见上面的 validatorExpression 属性。 类型:布尔型readOnly 属性下面有关使用 disabled 属性与使用 readOnly 属性的效果对比说明。类型:布尔型disabled 属性,JavaServer Faces 根本检测不到提交的任何值。类型:字符串title 属性,可以由屏幕阅读器读取并显示为工具提示。
类型:布尔型类型:布尔型rendered 属性。类型:字符串<input> 标记的 tabindex 属性。类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:字符串类型:布尔型immediate 操作的最常见示例是“取消”按钮。可以将其设置为 immediate 以跳过常规验证和更新步骤,但操作处理程序仍可以执行所需的操作。通常,操作处理程序将导航至先前的某个页面。在某些设计中,操作处理程序可能还会将信息消息放在队列中,例如“事务已取消”。还可能会执行其他操作,例如,应用程序可能会记录用户取消当前操作的情况。
类型:布尔型