進捗バーコンポーネントの使用方法
Matthew Bohm 氏によって作成された進捗バーコンポーネントを使用して、時間のかかるタスクの進捗状況を画面に表示できます。
進捗バーのパーセンテージは、管理対象 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 - value 属性が参照するメソッドの呼び出し時間間隔 (ミリ秒数) で返すリテラルまたは値式。
- percentageText - それまでの進捗状況を示すためのカスタムテキスト。
- startOperation - 時間がかかるプロセスを開始するメソッドバインド。AJAX 経由で呼び出されます。
- stopOperation - 時間がかかるプロセスを停止するメソッドバインド。AJAX 経由で呼び出されます。
- onComplete - 進捗状況が完了になった時に実行するスクリプト関数を表すリテラルまたは値式。
- onUpdate - 進捗状況が更新されるたびに実行するスクリプト関数を表すリテラルまたは値式。
- autoStart - ページの読み込み時に進捗バーがポーリングを開始するかどうかを示す boolean 値。
- action - スクリプト関数 bpui.progressbar.submitForm のクライアント側からの呼び出しで、ページが送信された場合に呼び出すアクションまたはリテラル。
- actionListener - このコンポーネントと、場合によってはほかのコンポーネントからアクションを受け取るメソッドを表すメソッドバインド。
- immediate - ユーザーによってこのコンポーネントがアクティブにされた場合、アプリケーション呼び出しフェーズを待たずに、すなわち要求値適用フェーズ中に、ただちに関係するリスナーおよびアクションに通知を送信することを示すフラグ。
- style - コンポーネント用の CSS スタイル。
- 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 の内容はすべて著作権保護されており、サン・マイクロシステムズ社の書面による許可なしに他の著作物に発表することを禁止します。