更新记录
1.0.1(2024-12-02) 下载此版本
- 兼容多端
1.0.0(2024-12-02) 下载此版本
- 首次发布
- 基础评分功能
- 支持自定义样式
- 支持半星评分
- 支持禁用状态
- 支持只读模式
- 支持触摸滑动
平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | - | - | - | √ | - | √ | √ |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
× | × | √ |
wht-rate 评分组件
一个功能丰富、易用的评分组件,支持自定义样式、半星评分等特性。
平台兼容性
H5 | 微信小程序 | APP-VUE | APP-NVUE |
---|---|---|---|
✓ | ✓ | ✓ | ✓ |
基础用法
<template>
<wht-rate v-model="value" />
</template>
<script>
export default {
data() {
return {
value: 3
}
}
}
</script>
组件属性
Props
属性名 | 说明 | 类型 | 默认值 |
---|---|---|---|
v-model | 当前评分值 | Number | 0 |
max | 最大评分值 | Number | 5 |
size | 图标大小(rpx) | Number | 40 |
icon | 选中时的图标 | String | ★ |
voidIcon | 未选中时的图标 | String | ☆ |
activeColor | 选中时的颜色 | String | #FFB800 |
voidColor | 未选中时的颜色 | String | #C8C9CC |
disabled | 是否禁用 | Boolean | false |
allowHalf | 是否允许半星 | Boolean | false |
readonly | 是否只读 | Boolean | false |
spacing | 图标间距(rpx) | Number | 4 |
Events
事件名 | 说明 | 回调参数 |
---|---|---|
change | 评分改变时触发 | value: 当前分值 |
update:modelValue | 更新v-model的值 | value: 当前分值 |
代码示例
基础用法
<wht-rate v-model="value" />
自定义图标
<wht-rate
v-model="value"
icon="heart"
void-icon="heart-o"
active-color="#FF6666"
/>
自定义样式
<wht-rate
v-model="value"
:size="50"
active-color="#FF0000"
void-color="#999999"
/>
半星评分
<wht-rate
v-model="value"
:allow-half="true"
/>
禁用状态
<wht-rate
v-model="value"
disabled
/>
评价场景示例
<template>
<view class="rate-box">
<view class="rate-item">
<text class="label">商品评分</text>
<wht-rate v-model="goodsRate" />
</view>
<view class="rate-item">
<text class="label">服务评分</text>
<wht-rate v-model="serviceRate" />
</view>
</view>
</template>
<script>
export default {
data() {
return {
goodsRate: 5,
serviceRate: 4
}
}
}
</script>
注意事项
- 组件依赖 uni-app 环境
- icon 属性支持任意字符或图标字体
- 建议评分图标大小保持一致
- 半星模式下不支持自定义图标
常见问题
Q1: 如何修改图标大小?
使用 size 属性设置,单位为 rpx
<wht-rate :size="60" />
Q2: 如何使用自定义图标?
可以使用图标字体或 Unicode 字符
<wht-rate icon="heart" void-icon="heart-o" />
Q3: 如何实现评分说明文字?
可以通过数组映射实现
<template>
<view class="rate-wrap">
<wht-rate v-model="value" />
<text>{{ rateTexts[value-1] }}</text>
</view>
</template>
<script>
export default {
data() {
return {
value: 3,
rateTexts: ['差评', '一般', '满意', '很好', '非常好']
}
}
}
</script>
更新日志
v1.0.0 (2024-03-20)
- 首次发布
- 基础评分功能
- 支持自定义样式
- 支持半星评分
贡献
如果您发现任何问题或有改进建议,欢迎提交 Issue 或 PR。
许可证
MIT © 2024