JSF 1.2 进度栏组件属性窗口
另请参见
在使用可视设计器编辑的某个页面上选择进度栏组件 时,将显示该组件的“属性”窗口。或者,也可以在 口中选择此组件。
此 JavaServer Faces 1.2 组件具有以下属性。
常规
id。 类型:字符串
页面 Bean 和 JSP 文件中进度栏组件的名称。在页面 Bean 中,由 PropertySheet 对象表示该组件。
外观
description。 类型:字符串
正在监视的任务的描述。
failedStateText。 类型:字符串
任务失败时显示的文本。缺省情况下,将与文本一起显示一个图标。
height。 类型:整型
进度栏图像的高度(以像素为单位)。缺省高度是 14 像素。
logMessage。 类型:字符串
在组件底部的文本区域中显示的消息。
progress。 类型:整型
表示已完成总任务的百分比的数值。将此属性绑定到生成所需的整型数据的对象。
progressImageUrl。 类型:字符串
用于表示进度的图像(而非缺省的动画进度栏)的 URL。
refreshRate。 类型:整型
进度栏图像更新的间隔(以毫秒为单位)。
status。 类型:字符串
在组件底部显示的文本,用于表示任务的当前状态。例如,此状态可能是一个字符串,用于表示已完成工作的百分比,或剩余时间。
style。 类型:字符串
要应用到组件中的层叠样式表规则(CSS 级别 2)。例如:
position: absolute; left: 288px; top: 312px
您既可以直接输入值,也可以单击省略号 (...) 按钮以使用样式编辑器 。
此属性将覆盖此组件的主题或项目 CSS 文件中的所有设置。如果在此属性中指定的样式未生效,其原因是组件区域被具有不同样式设置的子组件遮盖住了。
有关 CSS2 样式属性的列表,请参见以下 Web 页:
styleClass。 类型:字符串
呈现组件时应用的以空格分隔的 CSS2 样式类列表。必须在项目的样式表或主题的 CSS 文件中定义这些样式类。单击省略号按钮 (...),将会看到一个列表,其中包含可添加到此属性中的所有样式。有关将 CSS 类和规则添加到项目的层叠样式表的信息,请参见 CSS 编辑器 。
有关已添加到此属性中的类为何没能对组件产生影响的说明,请参见上文中的 style 属性描述。
如果将当前主题 中的 CSS 样式类添加到项目 CSS 文件中并重新定义了样式类,则所做更改会影响到使用此样式类的所有组件。但是,您可以将自己的样式类添加到重新定义缺省样式类的项目 CSS 文件中,随后在将这些类添加到此属性时,所做更改只影响此组件的实例。
width。 类型:整型
进度栏图像的宽度(以像素为单位)。
行为
toolTip。 类型:字符串
呈现为组件的 HTML title 属性,当用户将鼠标光标悬停在该组件上时,可通过屏幕阅读器读取,并作为工具提示显示。
如果该组件不可见,则在大多数浏览器中将不显示工具提示。
visible。 类型:布尔型
指示用户能否在呈现的 HTML 页面上看到组件。缺省情况下,将选定此属性。如果取消选择此属性,则组件的 HTML 代码将呈现在页面上,但该组件在浏览器中不可见,因为它被样式设置隐藏了。由于 HTML 代码呈现出来,因此在提交表单时仍然可以处理组件,而且在浏览器中查看源代码的用户可以看到 HTML 代码。此外,您的 Web 应用程序可以使用客户端 JavaScript 来显示或隐藏组件。
如果需要完全隐藏组件(例如,由于它包含某些用户不应该看到的敏感信息),请取消选择 rendered 属性。
辅助功能
tabIndex。 类型:字符串
(可选)按文档的 Tab 键顺序指定组件的位置,从而确定当用户使用 Tab 键在文档中移动时组件成为焦点的时间。该值必须为 0 至 32767 之间的整数。相当于 HTML <input> 标记的 tabindex 属性。
高级
overlayAnimation。 类型:布尔型
如果选定该属性,则来自 progress 属性中的完成百分比数值会叠加到进度栏动画上。如果未选定该属性,则此数值将显示在进度栏下面的行中。在空间受到限制的情况下,此技术非常有用。
rendered。 类型:布尔型
如果选定该属性,将在任何后续页提交中呈现和处理组件。如果未选定该属性,进度栏将不会出现在页面中,甚至不作为隐藏组件出现。
taskState。 类型:字符串
表示与此进度栏相关联的任务当前状态的字符串。可以单击此属性旁边的下拉列表以选择值。缺省值是 not_started。如果未设置此属性,该组件会自动将其设置为 running(如果 progress 属性的值小于 100 且大于 0),或设置为 completed(如果 progress 属性的值等于 100)。
type。 类型:布尔型
进度栏的一般类型。类型如下:
确定性。 用于显示已完成的任务百分比的动画水平栏。
不确定性。 在无法确定某个任务的完成百分比时,用于仅显示该任务正在执行的动画水平栏。
忙。 在无法确定某个任务的完成百分比时,仅限于指示任务活动的较小动画。
另请参见
进度栏组件
属性组件
进度栏部分组件
使用组件
组件任务:快速参考
法律声明