1.0.1 • Published 4 years ago
@ophiuchus/rate v1.0.1
Rate 评分
介绍
用于对事物进行评级操作。
引入
import Vue from 'vue';
import Rate from '@ophiuchus/rate';
Vue.use(Rate);代码演示
基础用法
<sf-rate v-model="value" />export default {
  data() {
    return {
      value: 3,
    };
  },
};自定义图标
<sf-rate v-model="value" icon="like" void-icon="like-o" />自定义样式
<sf-rate
  v-model="value"
  :size="25"
  color="#ffd21e"
  void-icon="star"
  void-color="#eee"
/>半星
<sf-rate v-model="value" allow-half void-icon="star" void-color="#eee" />export default {
  data() {
    return {
      value: 2.5,
    };
  },
};自定义数量
<sf-rate v-model="value" :count="6" />禁用状态
<sf-rate v-model="value" disabled />只读状态
<sf-rate v-model="value" readonly />监听 change 事件
<sf-rate v-model="value" @change="onChange" />export default {
  method: {
    onChange(value) {
      Toast('当前值:' + value);
    },
  },
};API
Props
| 参数 | 说明 | 类型 | 默认值 | 
|---|---|---|---|
| v-model | 当前分值 | number | - | 
| count | 图标总数 | number | string | 5 | 
| size | 图标大小,默认单位为 px | number | string | 20px | 
| gutter | 图标间距,默认单位为 px | number | string | 4px | 
| color | 选中时的颜色 | string | #ee0a24 | 
| void-color | 未选中时的颜色 | string | #c8c9cc | 
| disabled-color | 禁用时的颜色 | string | #c8c9cc | 
| icon | 选中时的图标名称或图片链接 | string | star | 
| void-icon | 未选中时的图标名称或图片链接 | string | star-o | 
| icon-prefix | 图标类名前缀,同 Icon 组件的 class-prefix 属性 | string | sf-icon | 
| allow-half | 是否允许半选 | boolean | false | 
| readonly | 是否为只读状态 | boolean | false | 
| disabled | 是否禁用评分 | boolean | false | 
| touchable | 是否可以通过滑动手势选择评分 | boolean | true | 
Events
| 事件名 | 说明 | 回调参数 | 
|---|---|---|
| change | 当前分值变化时触发的事件 | 当前分值 | 
样式变量
组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考主题定制。
| 名称 | 默认值 | 描述 | 
|---|---|---|
| @rate-icon-size | 20px | - | 
| @rate-icon-gutter | @padding-base | - | 
| @rate-icon-void-color | @gray-5 | - | 
| @rate-icon-full-color | @red | - | 
| @rate-icon-disabled-color | @gray-5 | - |