格付けコンポーネントの使用方法
Matthew Bohm 作成の格付け JSF コンポーネントを使用して、項目を格付けし、AJAX 呼び出しでそのモデルを更新させることができます。
このコンポーネントは管理対象 Bean を使用して、得られたユーザー格付け選択情報だけでなく、詳細プロパティーも設定できます。
格付けコンポーネント用のタグライブラリには、次の宣言を使用してアクセスできます。
<%@taglib prefix="ui" uri="http://java.sun.com/blueprints/ui/14"%>
格付け JSF コンポーネントの使用例を次に示します。
<ui:rating id="rating" maxGrade="5" includeNotInterested="true" includeClear="true"
hoverTexts="#{RatingBean.ratingText}" notInterestedHoverText="Not Interested"
clearHoverText="Clear Rating" grade="#{RatingBean.grade}"/>
JSP タグ属性
格付けコンポーネントは次の属性をサポートしています。
- includeClear - ユーザーの格付けを消去するコントロールを表示するかどうかを示すフラグ。
- includeModeToggle - モード (格付けの平均の表示、またはユーザーの格付けの表示) を切り替えるコントロールを表示するかどうかを示すフラグ。
- includeNotInterested - 「not interested」 コントロールを表示するかどうかを示すフラグ。
- includeText - テキスト用の領域を表示するかどうかを示すフラグ。
- style - 一番外側に表示される要素に適用するスタイル。
- styleClass - 一番外側に表示される要素に適用するスタイルクラス。
- averageGrade - この項目に対する一般的なユーザーの評価平均。0.0 〜 maxGrade の範囲です。このプロパティーは、実行時に動的に機能するようバインドする必要があります。
- averageModeHoverText - 平均モードに切り替えることを可能にするモード切替コントロールに使用するカスタムホバリングテキスト。
- averageModeText - マウスが置かれていなくて、コンポーネントが平均モードの時に表示するテキスト。バインドされている場合、このプロパティーは AJAX 経由でクライアントに送信されます。
- clearHoverText - 「clear」コントロールに使用するカスタムホバリングテキスト。
- grade - この項目に対するユーザーの評価 (「star」の数)。「not interested」の場合は RatingComponent.NOT_INTERESTED_GRADE、「clear」の場合は RatingComponent.CLEAR_GRADE を使用します。このプロパティーは、実行時に動的に機能するようバインドする必要があります。
- hoverTexts - 「star」コントロールに使用するカスタムホバリングテキストテキストの配列。配列のメンバーとして null を指定できます。
- inAverageMode - コンポーネントの初期表示を評価平均にするかどうかを示すフラグ。False の場合は、ユーザー評価が初期表示されます (通常モード)。
- maxGrade - この格付けインスタンスの最高評価 (「star」の数)。
- normalModeHoverText - 通常モードに切り替えることを可能にするモード切替コントロールに使用するカスタムホバリングテキスト。
- normalModeText - マウスが置かれていなくて、コンポーネントが通常モードの時に表示するテキスト。バインドされている場合、このプロパティーは AJAX 経由でクライアントに送信されます。
- notInterestedHoverText - 「not interested」コントロールに使用するカスタムホバリングテキスト。
- averageModeAcknowledgedText - ユーザーがモード切替コントロールをクリックして平均モードに切り替えた時に表示するテキスト。
- gradeAcknowledgedText - ユーザーが項目を評価 (たとえば、モード切替以外のコントロールをクリック) した時に表示するテキスト。
- gradeReadOnly - この格付けインスタンスの評価をユーザーが変更ができるかどうかを示すフラグ。
- modeReadOnly - モード切替コントロールを使って、この格付けインスタンスのモードをユーザーが変更できるかどうかを示すフラグ。
- normalModeAcknowledgedText - ユーザーがモード切替コントロールをクリックして通常モードに切り替えた時に表示するテキスト。
- onGrade - 「interested」および「clear」を含めてユーザーが評価を行った時に呼び出すスクリプト関数。
- onModeToggle - ユーザーがモードを切り替えた時に呼び出すスクリプト関数。
- rendered - コンポーネントを表示するかどうかを示すフラグ。
© Sun Microsystems 2006. Java BluePrints Solutions Catalog の内容はすべて著作権保護されており、サン・マイクロシステムズ社の書面による許可なしに他の著作物に発表することを禁止します。