tui-grade 评分

介绍

可设置大小颜色，支持选择半星，支持手势touch选择。

引入

uni-app引入

第一种，手动引入（可全局引入）

import tuiGrade from "@/components/thorui/tui-grade/tui-grade.vue"
export default {
	components:{
		tuiGrade
	}
}

第二种，开启easycom组件模式，如果不了解如何配置，可先查看 官网文档 (opens new window)。

uni-app版本平台差异说明

App-Nvue	App-vue	H5	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序
升级中	√	√	√	√	√	√	√

微信小程序引入（可在app.json中全局引入）

{
  "usingComponents": {
    "tui-grade": "/components/thorui/tui-grade/tui-grade"
  }
}

代码演示

部分功能演示，具体可参考示例程序以及文档API。

基础用法

通过 score 属性设置当前评分（小数只支持半星0.5），评分改变时触发 change 事件。

<!--uni-app-->
<tui-grade :score="score" @change="change"></tui-grade>

<!--微信小程序-->
<tui-grade score="{{score}}" bindchange="change"></tui-grade>

/*methods*/

//uni-app
change: function(e) {
	this.score = e.score;
}

//微信小程序
change: function(e) {
    this.setData({
	 score:e.detail.score
   })
 }

设置星星数

通过 quantity 属性设置星星数量，默认值为5。

<!--uni-app-->
<tui-grade :score="score" :quantity="8" @change="change"></tui-grade>

<!--微信小程序-->
<tui-grade score="{{score}}" quantity="{{8}}" bindchange="change"></tui-grade>

设置星星样式

通过 size 属性设置星星大小，normal 属性设置未选中颜色，active 属性设置选中颜色。

<!--uni-app-->
<tui-grade :score="score" :size="16" normal="#ccc" active="#ff7900" @change="change"></tui-grade>

<!--微信小程序-->
<tui-grade score="{{score}}" size="{{16}}" normal="#ccc" active="#ff7900" bindchange="change"></tui-grade>

禁用状态

通过 disabled 属性设置禁用状态，不可选择。

<!--uni-app-->
<tui-grade :score="score" disabled></tui-grade>

<!--微信小程序-->
<tui-grade score="{{score}}" disabled></tui-grade>

设置星星间距

通过 width 属性设置星星间距，设置的值需要大于等于 size 属性值。

<!--uni-app-->
<tui-grade :score="score" @change="change" :width="24"></tui-grade>

<!--微信小程序-->
<tui-grade score="{{score}}" bindchange="change" width="{{24}}"></tui-grade>

Slots

none

Props

参数	类型	说明	默认值
quantity	Number	星星数量	5
score	[Number, String]	当前评分，小数只支持半星0.5	0
disabled	Boolean	是否禁用点击	false
size	Number	星星大小，单位px	20
width	Number	星星宽度，大于等于size属性值，设置间距使用，单位px	20
normal	String	未选中颜色	#b2b2b2
active	String	选中颜色	#e41f19
isHalf	Boolean	是否支持半星选择/展示	true
halfRate	Number	超过多少比例选中半星（取值区间0~0.5）	0.25
params	[Number, String]	自定义参数，触发事件时回传	0

Events

事件名	说明	回调参数
change	评分改变时触发	{   score:Number, //当前评分   params: params //自定义参数 }

预览

请以移动端效果为准，touch事件目前尚未在PC端做兼容。

线上程序扫码预览

ThorUI组件库小程序码	H5二维码	ThorUI示例小程序码