Rating
概述
Rating是星级评分组件,基于sl-rating渲染,以点选星星的方式录入评分值,常用于评价、打分场景。默认 5 颗星,支持调整最大星数与评分精度。
示例
声明一个评分字段只需要指定widget: 'rating':
ts
const form = document.querySelector('#form');
form.state = {
score: configurable(3, {
label: '评分',
widget: 'rating',
}),
};loading
指南
基础用法
默认最多 5 颗星、步进 1 分:
ts
form.state = {
score: configurable(3, {
label: '评分',
widget: 'rating',
}),
};最大星数
通过max调整星星数量:
ts
form.state = {
score: configurable(3, {
label: '最大评分',
max: 10,
widget: 'rating',
}),
};半星精度
precision=0.5时支持半星选择,可以打出2.5这样的分值:
ts
form.state = {
score: configurable(3, {
label: '精度评分',
precision: 0.5,
widget: 'rating',
}),
};属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
max | number | 5 | 最高星数 |
precision | number | 1 | 评分精度(如0.5支持半星) |
注意事项
Rating的值是数值类型,配合max/precision可以确定有效区间与最小步进。- 只读展示时(如详情页)星星不可交互,仅呈现当前分值。