如何使用评级组件
通过使用 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 - 是否应呈现“不感兴趣”控件。
- styleClass - 要应用于呈现的最外层元素的样式类。
- averageGrade - 一般用户群体为该项评定的平均级别。必须介于 0.0 和 maxGrade 之间。必须绑定此属性以在运行时动态进行工作。
- averageModeHoverText - 用于模式切换控件的定制悬停文本,切换控件为用户提供了切换到平均模式的功能。
- averageModeText - 当鼠标没有悬停并且组件处于平均模式时显示的文本。如果绑定,则通过 AJAX 将此属性发送到客户端。
- clearHoverText - 用于“清除”控件的定制悬停文本。
- grade - 用户为该项评定的级别(“星”数)。对于“不感兴趣”级别,请使用 RatingComponent.NOT_INTERESTED_GRADE;对于“清除”级别,请使用 RatingComponent.CLEAR_GRADE。必须绑定此属性以在运行时动态进行工作。
- hoverTexts - 用于“星”控件的定制悬停文本数组。Null 可以作为数组成员。
- inAverageMode - 是否初始呈现显示平均级别的组件。如果为 False,则初始呈现显示用户级别的组件(正常模式)。
- maxGrade - 此评级实例允许的最大级别(“星”数)。
- normalModeHoverText - 用于模式切换控件的定制悬停文本,切换控件为用户提供了切换到正常模式的功能。
- normalModeText - 当鼠标没有悬停并且组件处于正常模式时显示的文本。如果绑定,则通过 AJAX 将此属性发送到客户端。
- notInterestedHoverText - 用于“不感兴趣”控件的定制悬停文本。
- averageModeAcknowledgedText - 当用户单击模式切换控件以切换到平均模式时显示的文本。
- gradeAcknowledgedText - 当用户为该项评级时(即,当用户单击模式切换以外的控件时)显示的文本。
- gradeReadOnly - 用户能否更改此评级实例的级别。
- modeReadOnly - 用户能否通过模式切换控件来更改此评级实例的模式。
- normalModeAcknowledgedText - 当用户单击模式切换控件以切换到正常模式时显示的文本。
- onGrade - 用户评级(包括“不感兴趣”或“清除”)时调用的脚本函数。
- onModeToggle - 用户切换模式时调用的脚本函数。
© Sun Microsystems 2006。Java BluePrints Solutions Catalog 中的所有内容受版权保护,未经 Sun Microsystems 的明确书面许可,不得在其他产品中发布。