类名: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>