更新记录
1.0.0(2025-03-17)
下载此版本
发布初版
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
app-vue |
× |
√ |
× |
× |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
× |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
Rate 评分
组件名: xt-rate
适配情况需自行尝试,开发时只测试了 H5、APP、微信小程序
安装方式
本组件符合 easycom 规范,HBuilderX 3.1.0 起,只需将本组件导入项目,在页面 template 中即可直接使用,无需在页面中 import 和注册 components
注意事项
如何阻止事件冒泡
vue2:在组件上直接使用@click.native.stop
,如:<xt-icon @click.native.stop='click'></xt-icon>
;
vue3:由于 vue3 没有native
修饰符,所以不能直接在组件上使用.stop
修饰符,只能嵌套一层view
标签,在外层view
上添加@click.stop
阻止冒泡
基本用法
<template>
<view class="xt">
<view>
<view>基础使用</view>
<xt-rate v-model="rate"></xt-rate>
</view>
<view>
<view>自定义图标(xt-icon内的)</view>
<xt-rate
v-model="rate"
active-icon="xt-icon-shoucang1"
inactive-icon="xt-icon-shoucang"
></xt-rate>
</view>
<view>
<view>自定义颜色</view>
<xt-rate
v-model="rate"
active-color="#1e90ff"
inactive-color="#7bed9f"
></xt-rate>
</view>
<view>
<view>选择半分</view>
<xt-rate
allowHalf
active-icon="xt-icon-shoucang1"
inactive-icon="xt-icon-shoucang"
></xt-rate>
</view>
</view>
</template>
<script>
export default {
data() {
return {
rate: 2,
};
},
methods: {},
};
</script>
<style lang="scss">
.xt {
padding: 0 20rpx;
display: flex;
flex-direction: column;
gap: 30rpx;
}
</style>
API
属性名 |
类型 |
说明 |
默认值 |
value |
String | Number |
选中的数量 |
1 |
count |
Number | String |
总数量 |
5 |
disabled |
Boolean |
是否禁止操作 |
false |
readonly |
Boolean |
是否只读 |
false |
size |
String | Number |
大小 |
50rpx |
inactiveColor |
String |
未选中的颜色 |
#e6e6e6 |
activeColor |
String |
选中的颜色 |
#ff4757 |
gap |
String | Number |
间距 |
5rpx |
minCount |
Number |
最少选中的个数 |
1 |
allowHalf |
Boolean |
是否允许半分 |
false |
activeIcon |
String |
选中时的图标名,只能为 xt-icon 的内置图标 |
xt-icon-aixin1 |
inactiveIcon |
String |
未选中时的图标名,只能为 xt-icon 的内置图标 |
xt-icon-aixin |
touchable |
Boolean |
是否可以滑动选择 |
false |
customStyle |
Object |
自定义样式 |
- |
Events
方法名 |
类型 |
说明 |
change |
Function |
选中值改变的时候触发 |