如何使用进度栏组件
通过使用 Matthew Bohm 创建的进度栏 JSF 组件,用户可以在屏幕上显示长时间运行的任务的进度。进度百分比是通过一个对管理 Bean 的 AJAX 调用进行更新的。该组件还简化了在任务完成后回调 Javascript 函数的过程。可以使用以下声明来访问评级组件的标记库:
<%@taglib prefix="ui" uri="http://java.sun.com/blueprints/ui/14"%>
使用 JSF 进度栏组件的示例如下所示:
<ui:progressBar id="progressBar" interval="1000"
onComplete="progressComplete" startOperation="#{ProgressBarBean.startTask}"
percentage="#{ProgressBarBean.percentage}" style="width: 400px"/>
JSP 标记属性
评级组件支持以下属性。
- percentage - 值表达式,返回一个介于 0 和 100 之间的数字。
- interval - 文字或值表达式,返回值属性引用的方法调用的间隔毫秒数。
- percentageText - 定制文本,表示到目前为止的进度。
- startOperation - 方法绑定,通过 AJAX 进行调用,启动长时间运行的进度。
- stopOperation - 方法绑定,通过 AJAX 进行调用,停止长时间运行的进度。
- onComplete - 文字或值表达式,表示在进度完成时执行的脚本函数。
- onUpdate - 文字或值表达式,表示每次更新进度时执行的脚本函数。
- autoStart - 布尔值,指示在装入页面时此进度栏是否开始轮询。
- action - 通过一个对脚本函数 bpui.progressbar.submitForm 的客户端调用来提交页面时,用于调用的操作或文字。
- actionListener - 方法绑定,表示从此组件(也可能是其他组件)接收操作的方法。
- immediate - 一个用于指明情况的标志:如果此组件是由用户激活的,则会立即将通知传送到相关的侦听程序和操作(即,在“应用请求值”阶段),而不是一直等到“调用应用程序”阶段才进行传送。
- styleClass - 组件的 CSS 样式类。
- binding - 页面 Bean 中组件的绑定。
CSS 覆盖
如果要覆盖进度栏的外观,可以配置进度栏所使用的类名称。例如:
<style>
.bpui_progressbar_barAreaContainer {
border-style: groove !important;
border-width: medium !important;
}
.bpui_progressbar_portionComplete {
background: #FF0000 !important;
}
.bpui_progressbar_portionRemaining {
background: lightgrey !important;
}
</style>
© Sun Microsystems 2006。Java BluePrints Solutions Catalog 中的所有内容受版权保护,未经 Sun Microsystems 的明确书面许可,不得在其他产品中发布。