JSF 1.2 属性组件属性窗口
另请参见
在“导航”窗口 的属性表单 组件下选择属性组件 的节点时,将显示该组件的“属性”窗口。
此 JavaServer Faces 1.2 组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中的属性组件的名称。在页面 Bean 中,由 Property 对象表示该组件。
外观
helpText。 类型:字符串
属性的内联帮助信息。如果将组件(如文本字段)添加到属性中,则会在组件下面显示此帮助文本。
label。 类型:字符串
显示属性相关信息(通常为属性名称)的标签或文本。标签的 for 属性将设置为属性中的第一个输入组件(如果存在)。例如,如果将文本字段放到属性上以使用户能够编辑属性的值,则会将标签的 for 属性设置为文本字段的 id。如果设置了输入组件的 required 属性,则标签可以使用通过 for 属性建立的此连接来显示必填字段图标。
labelAlign。 类型:字符串
指定标签在其列中的对齐方式。虽然标签位于包含的任何输入组件的左侧,但是标签与其列的左边距和右边距的对齐方式将发生变化。除非使用多个具有不同长度标签的属性组件,否则可能看不到设置此属性所产生的任何效果。
noWrap。 类型:布尔型
指定能否对标签的文本换行。如果选定该属性,则标签的文本将无法换行,并且必须完全显示在一行上。
overlapLabel。 类型:布尔型
指定能否看到标签。如果选定该属性,则该属性的内容将包含该标签。
style。 类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串
呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的 style 属性描述。
如果将当前主题 中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类,则所做更改会影响到使用此样式类的所有组件。但是,您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中,随后在将这些类添加到此属性时,所做更改只影响此组件的实例。
行为
disabled。 类型:布尔型
如果选定,则表示该组件应该从不接收焦点或被包含在提交中。
visible。 类型:布尔型
指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下,将选定此属性。如果取消选择此属性,则组件的 HTML 代码将呈现在页面上,但该组件在浏览器中不可见,因为它被样式设置隐藏了。由于 HTML 代码呈现出来,因此在浏览器中查看源代码的用户可以看到 HTML 代码。此外,您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
如果需要完全隐藏组件(例如,由于它包含某些用户不应该看到的敏感信息),请取消选择 rendered 属性。
高级
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理属性。如果未选定该属性,属性组件将不出现在页面中(甚至不作为隐藏组件出现),并且忽略 visible 属性。
另请参见
属性组件
属性表单部分组件
属性表单组件
使用组件
组件任务:快速参考
法律声明