Rate 评分
等级评估。
何时使用
用户对一个产品进行评分时可以使用。
只读模式
:::demo
<template>
<d-rate :read="true" v-model="valueReadonly" />
</template>
<script>
import { ref, defineComponent } from 'vue';
export default defineComponent({
setup() {
const valueReadonly = ref(3.5);
return {
valueReadonly,
};
},
});
</script>
:::
动态模式
:::demo
<template>
<d-rate v-model="valueDynamic" icon="star-o" />
</template>
<script>
import { ref, defineComponent } from 'vue';
export default defineComponent({
setup() {
const valueDynamic = ref(2);
return {
valueDynamic,
};
},
});
</script>
:::
动态模式-自定义
:::demo
<template>
<d-rate character="A" color="#ffa500" v-model="valueCustom" :count="6" />
</template>
<script>
import { ref, defineComponent } from 'vue';
export default defineComponent({
setup() {
const valueCustom = ref(3);
return {
valueCustom,
};
},
});
</script>
:::
半选模式
:::demo
<template>
<d-rate v-model="valueHalf" :allow-half="true" @change="change" />
</template>
<script>
import { ref, defineComponent } from 'vue';
export default defineComponent({
setup() {
const valueHalf = ref(2.5);
const change = (val) => {
console.log(val);
};
return {
valueHalf,
change,
};
},
});
</script>
:::
使用 type 参数
:::demo
<template>
<div>
<d-rate v-model="value1" :read="true" type="success" :count="5" icon="star" />
</div>
<div>
<d-rate v-model="value2" :read="true" type="warning" :count="5" icon="star" />
</div>
<div>
<d-rate v-model="value3" :read="true" type="error" :count="5" />
</div>
</template>
<script>
import { ref, defineComponent } from 'vue';
export default defineComponent({
setup() {
const value1 = ref(3.5);
const value2 = ref(2);
const value3 = ref(3);
return {
value1,
value2,
value3,
};
},
});
</script>
:::
Rate 参数
| 参数名 | 类型 | 默认值 | 描述 | 跳转 Demo |
|---|---|---|---|---|
| read | boolean |
false | 可选,设置是否为只读模式,只读模式无法交互 | 只读模式 |
| count | number |
5 | 可选,设置总等级数 | 只读模式 |
| type | RateStatusType | -- | 可选,设置当前评分的类型,不同类型对应不同颜色 | 使用 type 参数 |
| color | string |
-- | 可选,星星颜色 | 动态模式-自定义 |
| icon | string |
-- | 可选,评分图标的样式,只支持 devUI 图标库中所有图标 | 动态模式 |
| character | string |
-- | 可选,评分图标的样式,icon 与 character 只能设置其中一个 | 动态模式-自定义 |
| allow-half | boolean |
false | 可选,动态模式下是否允许半选 | 半选模式 |
Rate 事件
| 事件名 | 类型 | 说明 | 回调参数 | 跳转 Demo |
|---|---|---|---|---|
| change | EventEmitter<number> |
分值改变时触发 | 改变后的分值 | 半选模式 |
Rate 类型定义
RateStatusType
type RateStatusType = 'success' | 'warning' | 'error';