EX Rating 评分(级)插件

目录
  1. 插件说明
  2. 配置参数
  3. 属性值
  4. 方法
  5. 如何使用
  6. 示例

类名:Rating
Rating 是 EXCMS(卓越内容管理系统) 前台插件,利用星星图片实现评分和显示评分功能。

new Rating(Object config);

Config 配置参数
参数 类型 选项 说明
gid Number 必填 评分组ID
contentid String 必填 内容ID
url String 必填 评分动作请求URL
renderTo Mixed   评分插件父容器(renderTo ,el二者必须选一)
el Mixed   评分插件容器,HTML对象,或对象ID
cls String   评分插件样式
scoreTextEl Mixed   得分文本容器
hideStar Boolean   是否隐藏星星图片(不设置时为评分组设置)
scoreText String   得分文本,默认值({score}分)(不设置时为评分组设置)
hideScoreText Boolean   是否隐藏得分文本(不设置时为评分组设置)
loginVote Boolean   是否登录评分(不设置时为评分组设置)
denyVote Boolean   是否禁止评分(不设置时为评分组设置)
reVote Boolean   是否可以重复评分(不设置时为评分组设置)
属性值
参数 类型 说明
score Number 当前得分
sumScore Number 总分
voters Number 参与评分总人数
userVoters Number 用户参与评分人数
方法
参数 说明
Rating(Object config) 创建评分插件
applyTo(String/HTMLElement el) 将插件应用到HTML元素 el上
commit 提交评分
disable 禁用评分插件,禁用后将无鼠标事件且不能评分
getWidth 获取当前得分高亮的宽度
getScore 获取当前得分
load 加载评分数据
setScoreText(String scoreText) 设置得分文本
setScore(Number score) 设置得分

如何使用

在要使用本插件的模板中引入 rating 目录下的 rating.css:

<link type="text/css" rel="stylesheet" href="/plugins/rating/rating.css">

引入 rating.js :

<script language="JavaScript" type="text/javascript" src="/plugins/rating/rating.js"></script>

在要显示评分的位置放入:

<script language="JavaScript" type="text/javascript">new Rating({literal}{{/literal}gid:'评分组ID', contentid:'内容ID', url:'/apps/rating/rating.php{literal}}{/literal}');</script>

示例

说明:以下示例以评分组ID为 1,内容ID为 1,为参考。

1. 仅显示星星允许评分

config: {gid:'1', contentid:'1', url:'/apps/rating/rating.php',el:'rating-el-1', hideScoreText:true}

<script language="JavaScript" type="text/javascript">new Rating({literal}{gid:'1', contentid:'1', url:'/apps/rating/rating.php', el:'rating-el-1', hideScoreText:true}{/literal})</script>

2. 仅显示得分

config: {gid:'1', contentid:'1', url:'/apps/rating/rating.php', el:'rating-el-2', hideStar:true}

<script language="JavaScript" type="text/javascript">new Rating({literal}{gid:'1', contentid:'1', url:'/apps/rating/rating.php', el:'rating-el-2', hideStar:true}{/literal})</script>

3. 显示星星及得分,禁止评分

config: {gid:'1', contentid:'1', url:'/apps/rating/rating.php',el:'rating-el-3', denyVote:true}

<script language="JavaScript" type="text/javascript">new Rating({literal}{gid:'1', contentid:'1', url:'/apps/rating/rating.php', el:'rating-el-3', denyVote:true}{/literal})</script>

4. 显示小星星,不显示得分,禁止评分

config: {gid:'1', contentid:'1', url:'/apps/rating/rating.php',el:'rating-el-4', cls:'smallstar', hideScoreText:true, denyVote:true}

<script language="JavaScript" type="text/javascript">new Rating({literal}{gid:'1', contentid:'1', url:'/apps/rating/rating.php', el:'rating-el-4', cls:'smallstar', hideScoreText:true, denyVote:true}{/literal})</script>



更多效果,请自己研究实现,祝您成功.