JSF 1.2 标签集组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择标签集组件 时(在将该组件添加到页面上后),将显示该组件的“属性”窗口。
此 JavaServer Faces 1.2 组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中组件的名称。在 JSP 文件中,该名称是该组件的 id 属性的值。在页面 Bean 中,该属性的值是 TabSet 对象的名称。
外观
lite。 类型:布尔型
如果选定,将更改样式以使标签集在视觉效果上更浅一些。您还必须选择 mini 属性以实现此效果。
mini。 类型:布尔型
如果选定,将使标签及其文本小于正常尺寸。如果还选中 lite 属性,则标签尺寸甚至会更小,并且总体视觉效果也更浅一些。
style。 类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串 呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的 style 属性描述。
如果将当前主题 中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类,则所做更改会影响到使用此样式类的所有组件。但是,您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中,随后在将这些类添加到此属性时,所做更改只影响此组件的实例。
数据
selected。 类型:对象
表示选定标签的 ID。如果在可视设计器中单击标签,它将变为选定标签。此属性对于用作页面导航的标签集很有用。选定当前页面的标签时,该标签是用户所在页面的指示器。另外,不能将标签用作链接,并且标签不能具有与页面相同的背景颜色。
行为
visible。 类型:布尔型
指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下,将选定此属性。如果取消选择此属性,则组件的 HTML 代码将呈现在页面上,但该组件在浏览器中不可见,因为它被样式设置隐藏了。由于 HTML 代码呈现出来,因此在提交表单时仍然可以处理组件,而且在浏览器中查看源代码的用户可以看到 HTML 代码。此外,您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
如果需要完全隐藏组件(例如,由于它包含某些用户不应该看到的敏感信息),请取消选择 rendered 属性。
高级
actionListenerExpression。 类型:方法表达式
用于表示操作侦听程序方法的方法表达式,该侦听程序方法会在用户激活此组件时收到通知。值必须是有效的 JSF 方法表达式(如 #{Page1.action_method}),并且其计算结果必须为公共方法的名称,该方法使用 ActionEvent 参数并且返回类型为 void。
immediate。 类型:布尔型
当标签集的标签包含具有验证器的输入组件时,此属性影响标签集的行为方式。除非还为标签集设置了此属性,否则,不要为标签设置此属性。请参见标签集组件 结尾处的说明,其中介绍了为标签设置此属性和为标签集设置此属性的相互作用关系。通常,与其他组件一样,如果选定该属性,当用户激活组件时,将先执行页面 Bean 中的代码,然后再执行验证、更新模型值等操作。实际上,代码在服务器中立即执行,然后返回该页面。
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理标签。如果未选定该属性,标签将不出现在页面中,甚至不作为隐藏组件出现。
另请参见
标签集组件
使用组件
组件任务:快速参考
法律声明