评分组件
本 Component 是 uni ext component,需下载插件:uni-rate
评分组件,多用于购买商品后,对商品进行评价等场景
项目下有一个 /pages/uni-ui/rate/rate.uvue 页面,里面演示了rate组件的各种用法。
rate组件是投票评分使用的组件。它使用unicode字符实现,通过修改字体的样式,实现各种效果。
它分2个版本,一个版本是高性能版本,只有一层,不显示灰星,仅显示亮星,亮星不支持小数点,不能点击。适于长列表中显示。 另一个版本是普通版本,由背景灰星和前景亮星叠加而成,支持小数点,支持点击。 这2个版本通过属性full来切换。
本组件支持v-model绑定响应式数据。
rate组件有如下属性:
rate组件有onChange事件,事件回调中会给出点击触发的新评分值。
| 名称 | 类型 | 兼容性 | 描述 |
|---|---|---|---|
| value | number | 当前评分,取值范围 0~5 的数字 | |
| modelValue | number | v-model 绑定值,支持双向绑定,优先级高于 value | |
| full | boolean | 是否显示完整 5 颗星。为 true 时用灰星填充未选中位置;为 false 时仅显示亮星,性能更高但不支持点击交互 | |
| readonly | boolean | 是否只读,为 true 时不响应点击评分(full 为 false 时始终只读) | |
| plain | boolean | 灰星是否使用镂空样式(☆),为 false 时使用实心灰星(★) | |
| starClass | string(string.ClassString) | 灰星(未选中)的自定义样式类 | |
| starActiveClass | string(string.ClassString) | 亮星(选中)的自定义样式类 | |
| letterSpacing | number | 字间距 (px) | |
| @change | Event | 评分变化事件,参数为评分值,类型为 number | |
| @update:modelValue | Event | v-model 绑定值变化事件,参数为评分值,类型为 number |
示例为hello uni-app x alpha分支,与最新HBuilderX Alpha版同步。与最新正式版同步的master分支示例另见
示例
<template>
<text class="desc">
评分组件用于商品评价打分、服务态度评价、用户满意度等场景。\n
高性能模式仅有一个text组件,不可修改评分,适合长列表中显示的场景。\n
普通模式可以通过点击星星进行评分,且专门调大字号、调宽间距以适合点击。
</text>
<text class="title">高性能:只读,不显示灰星,不支持小数</text>
<uni-rate :value="3.6"/>
<text class="title">只读,显示灰星</text>
<uni-rate full readonly/>
<text class="title">只读,小数4.3</text>
<uni-rate full readonly :value="4.3"/>
<text class="title">只读,value大于5超限测试</text>
<uni-rate full readonly :value="100"/>
<text class="title">只读,value小于0超限测试</text>
<uni-rate full readonly :value="-1"/>
<text class="title">未选中的星星为镂空状态 + letterSpaceing组件属性</text>
<uni-rate full :value="3.5" :plain="true" :letter-spacing="10" star-class="big-font" star-active-class="big-font" />
<text class="title">未选中的星星为实心且响应change事件</text>
<uni-rate full :letter-spacing="10" star-class="big-font" star-active-class="big-font" @change="onRateChange" />
<text class="title">响应点击并双向绑定响应式变量</text>
<uni-rate full :letter-spacing="10" v-model="data.vModelRateValue" star-class="big-font" star-active-class="big-font" />
<text>{{data.vModelRateValue}}</text>
<text class="title">向右偏移 100px,点击评分</text>
<view id="rate-offset-test" class="offset-rate">
<uni-rate full v-model="data.offsetRateValue" :letter-spacing="10" star-class="big-font" star-active-class="big-font" />
</view>
<text class="desc">当前评分:{{ data.offsetRateValue }}</text>
<text class="title">只读,不触发change" </text>
<uni-rate readonly :value="5" @change="onRateChange" />
<text class="title">高性能只读,自定义大小和颜色(style方式),此时小数不生效</text>
<uni-rate style="font-size: 32px;color:red" :value="4.6" />
<!-- 仅高性能版,因为单层,可以在组件的style属性上写作用于text的样式。但规范的写法是使用externalClass -->
<text class="title">高性能只读,自定义间隔letter-spacing(class方式)" </text>
<uni-rate :value="4" star-active-class="big-letter-spacing"/>
<text class="title">自定义默认颜色和选中颜色 class方式</text>
<uni-rate :value="3" full star-class="custom-default big-font" star-active-class="custom-selected big-font"/>
<text class="title">只读,程序动态赋值,不触发change</text>
<uni-rate :value="data.rateValue" @change="onRateChange"/>
</template>
<script setup lang="ts">
type Data = {
vModelRateValue: number
rateValue: number
offsetRateValue: number
}
const data = reactive<Data>({
vModelRateValue: 0,
rateValue: 0,
offsetRateValue: 0
})
let interval = 0
function onRateChange(value: number) {
console.log('onRateChange received value:', value, 'type:', typeof value)
// 检查值是否有效
if (isNaN(value)) {
console.error('Invalid value received:', value)
uni.showToast({
title: '无效值: ' + value,
position: "bottom"
})
return
}
uni.showToast({
title: 'rate改变:' + value,
position: "bottom"
})
}
// 动态赋值示例
onMounted(() => {
// 每2秒改变一次评分值
interval = setInterval(() => {
data.rateValue = Math.floor(Math.random() * 6) // 0-5之间的随机整数
}, 2000)
})
onUnmounted(() => {
if (interval != 0) {
clearInterval(interval)
}
})
defineExpose({
data,
onRateChange
})
</script>
<style>
page{
padding: 10px;
}
.offset-rate {
margin-left: 100px;
align-self: flex-start;
}
.desc {
color: var(--text-color, #333333);
}
.custom-default{
color:black
}
.custom-selected{
color:red
}
.title{
font-weight: bold;
margin-top: 10px;
color: var(--text-color, #333333);
}
/* .star-active-class{
letter-spacing: 5px;
} */
.big-letter-spacing{
letter-spacing: 10px;
}
.big-font{
font-size: 24px;
}
</style>