JSF 1.2 标签组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择 JavaServer Faces 标签组件,或者在“导航”窗口 中选择该组件的标签 节点时,将显示该组件的“属性”窗口。
此 JavaServer Faces 1.2 组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中的标签组件的名称。
外观
for。 类型:字符串
此标签为其提供标签的组件。单击下拉列表可查看与标签关联的组件。设置此属性并不会将标签放在组件附近(必须通过拖放组件来执行此操作),但是该属性具有以下优点。
将标签组件与输入组件(如文本字段组件 )相关联时,标签组件会对关联组件中的设置和更改做出响应。具体说来,如果输入组件的 required 属性为 true,则标签组件将显示一个星号。如果因输入无效服务器拒绝了该页面的提交申请,则在页面中以红色显示标签组件的文本。
labelLevel。 类型:整型
影响标签外观的数值。1(强),较大并以粗体显示。2(中),为缺省值,较小并以粗体显示。3(弱),较小并正常显示(非粗体)。仅当设置了标签属性时,该属性才会生效。
requiredIndicator。 类型:布尔型
指示用户必须填充与标签关联的组件。如果关联组件没有 required 属性,或者未设置关联组件的 required 属性,则应使用此属性。选择此属性或对要标记的组件选择 required 属性后,将在标签旁边显示 required 图标。
style。 类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串 呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的 style 属性描述。
如果将当前主题 中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类,则所做更改会影响到使用此样式类的所有组件。但是,您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中,随后在将这些类添加到此属性时,所做更改只影响此组件的实例。
text。 类型:字符串
在标签上显示的文本。在页面上的标签组件中直接键入文本时,则会更新此属性。
数据
converter。 类型:转换器
JavaServer Faces 转换器,用于将 text 属性的值转换为 String 以对其进行显示。组件将为 text 属性选择正确的转换器(如果可用),从而不必在大多数情况下都设置此属性。如果与 text 属性绑定的值未列在转换器列表中,则必须提供您自己的转换器,并设置此属性。
如果将枚举转换器用于此组件,则必须编辑该转换器的 Java 声明以使用 enum 类作为参数(如枚举转换器 中所述)。
行为
toolTip。 类型:字符串
呈现为组件的 HTML title 属性,可以由屏幕阅读器读取并显示为工具提示。
如果禁用该组件,则在大多数浏览器中将不显示工具提示。
visible。 类型:布尔型
指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下,将选定此属性。如果取消选择此属性,则组件的 HTML 代码将呈现在页面上,但该组件在浏览器中不可见,因为它被样式设置隐藏了。由于 HTML 代码呈现出来,因此在提交表单时仍然可以处理组件,而且在浏览器中查看源代码的用户可以看到 HTML 代码。此外,您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
如果需要完全隐藏组件(例如,由于它包含某些用户不应该看到的敏感信息),请取消选择 rendered 属性。
JavaScript
onClick。 类型:字符串
用户单击组件时执行的 JavaScript。
onMouseDown。 类型:字符串
在鼠标光标位于组件上方且用户按下鼠标按钮时执行的 JavaScript。
onMouseMove。 类型:字符串
用户在组件中移动鼠标光标时执行的 JavaScript。
onMouseOut。 类型:字符串
在鼠标光标位于组件上方后用户将其从组件移开时执行的 JavaScript。
onMouseOver。 类型:字符串
用户将鼠标光标移动到组件上方时执行的 JavaScript。
onMouseUp。 类型:字符串
鼠标光标位于组件上方且用户释放鼠标按钮时执行的 JavaScript。
高级
hideIndicators。 类型:字符串
如果选定,则禁止同时显示标签以及 required 和 invalid 图标。在对要标记的组件选择 required 属性后,将在标签旁边显示 required 图标。如果在用户提交的页面上,该组件具有一个无效值,则会显示 invalid 图标。如果组件包含多个标签,并且只有一个标签会显示图标,则需要使用此属性。
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理标签。如果未选定该属性,标签则不会出现在页面中,甚至不作为隐藏组件出现。
另请参见
标签组件
使用组件
组件任务:快速参考
法律声明