JSF 1.2 气泡式帮助组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择气泡式帮助组件 时,将显示该组件的“属性”窗口。该组件的大多数属性既是 JSP 属性,又是页面 Bean 中 Bubble Help Java 组件的属性。
此 JavaServer Faces 1.2 组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中的气泡式帮助组件的名称。
外观
duration。 类型:字符串
弹出式窗口关闭之前等待的毫秒数。缺省值为 200 毫秒。
focusId。 类型:字符串
该属性用于将焦点设置为气泡内的元素。
style。 类型:字符串
在呈现组件时,要应用到最外层 HTML 元素中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 144px; top: 72px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串
在呈现组件时,要应用到最外层 HTML 元素中的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的 style 属性描述。
如果将当前主题 中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类,则所做更改会影响到使用此样式类的所有组件。但是,您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中,随后在将这些类添加到此属性时,所做更改只影响此组件的实例。
title。 类型:字符串
弹出式帮助标题的文本。
数据
converter。 类型:转换器
该属性用于指定一个转换方法,以便为组件实现自带属性值与 String 属性值之间的转换。
value。 类型:对象
组件的当前值。
行为
autoClose。 类型:布尔型
使用 autoClose 属性可自动关闭气泡式帮助。
closeButton。 类型:布尔型
使用 closeButton 属性可显示气泡的关闭按钮。
visible。 类型:布尔型
指示用户能否在呈现的 HTML 页面上看到组件。如果取消选择此属性,则组件的 HTML 代码将呈现在页面上,但该组件在浏览器中不可见,因为它被样式设置隐藏了。缺省情况下,将该值设置为 false,因此将包含组件 HTML,但不向用户显示组件。如果组件不可见,由于包含 HTML,因此仍然可以在后续表单提交期间对其进行处理。
辅助功能
tabIndex。 类型:整型
该属性用于将气泡式帮助组件设置为可访问组件。
高级
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理组件。如果未选定该属性,则组件将不出现在页面中,甚至不作为隐藏组件出现。如果需要隐藏组件但在提交页面时仍然可以对其进行处理,请取消选择 visible 属性,而不是此属性。
另请参见
气泡式帮助组件
使用组件
组件任务:快速参考
法律声明