更新记录

1.0.0(2025-03-17) 下载此版本

发布初版


平台兼容性

Vue2 Vue3
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 选中值改变的时候触发

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问