Business

Rate评分

用于展示事物评级以及快速打分。

用于展示事物评级以及快速打分。

示例图

Rate

基础用法

页面 .json 文件 usingComponents 中引入组件

// json
{
    "usingComponents": {
        "mx-rate": "/components/mxwui/rate/index"
    }
}

页面 .wxml 文件中使用组件

<mx-rate value="{{3}}" bind:rate_change="changeValue" />

更多用法示例

当前星级 value

属性:value,默认 0,数字。支持整数;开启半星后支持 0.5 步进。

<mx-rate value="{{3}}" />

半星 allowHalf

属性:allowHalf,默认 false,是否允许选择半星。

<mx-rate value="{{3.5}}" allowHalf />

只读 readonly

属性:readonly,默认 false,只读时无法交互。

<mx-rate value="{{4}}" readonly />

star 总数 count

属性:count,默认 5,展示的星级数量。

<mx-rate value="{{3}}" count="{{10}}" />

再次点击清除 allowClear

属性:allowClear,默认 true。为 true 时再次点击当前星级可清除为 0。

<mx-rate value="{{3}}" allowClear="{{false}}" />

间距 gutter

属性:gutter,默认 8,单位 rpx,星星之间的间距。

<mx-rate value="{{3}}" gutter="{{24}}" />

大小 size

属性:size,默认 48,单位 rpx。

<mx-rate value="{{3}}" size="{{64}}" />

颜色 color / voidColor

属性:color 为选中色,默认 #FF9F18;voidColor 为未选中色,默认 #EEEEEE。

<mx-rate value="{{3.5}}" allowHalf color="#CA0E2D" voidColor="#E1E5EC" />

自定义字符 character

属性:character,默认空。传入文本后优先以字符展示评分。

<mx-rate value="{{3}}" character="好" />

<mx-rate value="{{4}}" character="A" />

自定义图标 icon

属性:icon,默认 collect_checked(对应图标类 mx_collect_checked)。未设置 character 时使用该图标。

<mx-rate value="{{3}}" />

<mx-rate value="{{3.5}}" allowHalf icon="love_fill" color="#CA0E2D" />

受控模式

通过 value 与 bind:rate_change 配合实现受控。

<mx-rate value="{{value}}" bind:rate_change="changeValue" />
Page({
    data: {
        value: 3,
    },
    changeValue(e) {
        this.setData({
            value: e.detail.value,
        });
    },
});

事件

属性:bind:rate_change,打分回调事件。

<mx-rate bind:rate_change="changeValue" />

参数

参数 类型 必填 可选值 默认值 参数描述
value Number 是 数字 0 当前星级
count Number 数字 5 star 总数
allowHalf Boolean true、false false 是否允许半星
allowClear Boolean true、false true 是否允许再次点击后清除
readonly Boolean true、false false 是否只读
gutter Number 数字 8 间距,单位 rpx
size Number 数字 48 大小,单位 rpx
color String 颜色值 #FF9F18 选中颜色
voidColor String 颜色值 #EEEEEE 未选中颜色
character String 任意字符 '' 自定义字符,有值时优先于 icon
icon String 图标名称 collect_checked 评分图标,默认收藏星标

事件

事件名称 类型 返回值 事件说明
bind:rate_change Change event.detail 打分回调,返回 value 字段

其他说明

  • 支持点击选择,也支持按住滑动打分。
  • 开启 allowHalf 后,点击星星左半边为半星,右半边为整星。