评分默认被分为三个等级,可以利用颜色数组对分数及情感倾向进行分级(默认情况下不区分颜色)。 三个等级所对应的颜色用LowColor、MiddleColor、HighColor属性设置, 而它们对应的两个阈值则通过 LowThreshold 和 HighThreshold 设定。
评分默认被分为三个等级,可以利用颜色数组对分数及情感倾向进行分级(默认情况下不区分颜色)。 三个等级所对应的颜色用LowColor、MiddleColor、HighColor属性设置, 而它们对应的两个阈值则通过 LowThreshold 和 HighThreshold 设定。
默认不区分颜色
区分颜色
<Columns>
<Column class="@B.TextCentered">
<p>默认不区分颜色</p>
<p>
<Rate Value="val1"></Rate>
</p>
</Column>
<Divider IsVertical></Divider>
<Column class="@B.TextCentered">
<p>区分颜色</p>
<p>
<Rate @bind-Value="val2" LowColor="#99A9BF" MiddleColor="#F7BA2A" HighColor="#FF0000"></Rate>
</p>
</Column>
</Columns>
@code {
double val1 = 4;
double val2 = 2;
}
用辅助文字直接地表达对应分数,为组件设置 ShowText 属性会在右侧显示辅助文字。 通过设置 Texts 可以为每一个分值指定对应的辅助文字。Texts 为一个字符串数组,长度应等于最大值 Max。
<Rate @bind-Value="val" ShowText/>
@code {
double val = 3;
}
当有多层评价时,可以用不同类型的 icon 区分评分层级。 设置 LowIconClass、MiddleIconClass、VoidIconClass 属性可以自定义不同分段的图标。 。本例还使用 VoidIconClass 指定了未选中时的图标类名。
<Rate style="font-size: 2em" @bind-Value="val"
LowIconClass="fa-frown-o"
MiddleIconClass="fa-meh-o"
HighIconClass="fa-smile-o"
VoidIconClass="fa-meh-o">
</Rate>
@code {
double val = 0;
}
只读的评分用来展示分数,允许出现半星。 为组件设置 Disabled 属性表示组件为只读,支持小数分值。此时若设置 ShowScore,则会在右侧显示目前的分值。 可以提供 ScoreSlot 作为显示模板,模板的 context 是 Value 的值。
<Rate Value="val" Disabled ShowScore TextColor="#ff9900">
<ScoreSlot>@context</ScoreSlot>
</Rate>
@code {
//例子中的 ScoreSlot 是默认值,不用设置
double val = 3.7;
}
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
Value / @bind-Value | 绑定值 | double | — | 0 |
Max | 最大分值 | int | — | 5 |
Disabled | 是否为只读 | Bool | — | false |
LowThreshold | 低分和中等分数的界限值,值本身被划分在低分中 | int | — | 2 |
HighThreshold | 高分和中等分数的界限值,值本身被划分在高分中 | int | — | 4 |
LowColor、MiddleColor、HighColor | icon 的颜色。 | string | — | #F7BA2A |
VoidColor | 未选中 icon 的颜色 | string | — | #C6D1DE |
DisabledVoidColor | 只读时未选中 icon 的颜色 | string | — | #EFF2F7 |
LowIconClass、MiddleIconClass、HighIconClass | icon 的类名 | string | — | fa-star |
VoidIconClass | 未选中 icon 的类名 | string | — | fa-star-o |
DisabledVoidIconClass | 只读时未选中 icon 的类名 | string | — | fa-star |
ShowText | 是否显示辅助文字,若为真,则会从 Texts 数组中选取当前分数对应的文字内容 | bool | — | false |
ShowScore | 是否显示当前分数,ShowScore 和 ShowText 不能同时为真 | bool | — | false |
TextColor | 辅助文字的颜色 | string | — | |
Texts | 辅助文字数组 | string[] | — | ['极差', '失望', '一般', '满意', '惊喜'] |
ScoreSlot | 分数显示模板 | RenderFragment<double> | — | Value |
事件名称 | 类型 | 说明 | 回调参数 |
---|---|---|---|
OnChange | EventCallback<double> | 分值改变时触发 | 改变后的分值 |
文档