---
url: /docs/forms/components/rate.md
---
# Rate 评分组件

[ElementPlus 评分组件](https://element-plus.org/zh-CN/component/rate.html)

以下是去掉方法说明后面参数类型的中文文档，方法标题不使用反引号：

# 方法说明

### 设置最大分值

```php
$this->max(5);
```

最大分值，默认值: 5。

***

### 设置只读状态

```php
$this->disabled(true);
```

是否为只读，默认值: false。

***

### 设置是否允许半选

```php
$this->allowHalf(true);
```

是否允许半选，默认值: false。

***

### 设置低分和中等分数的界限值

```php
$this->lowThreshold(2);
```

低分和中等分数的界限值，值本身被划分在低分中，默认值: 2。

***

### 设置高分和中等分数的界限值

```php
$this->highThreshold(4);
```

高分和中等分数的界限值，值本身被划分在高分中，默认值: 4。

***

### 设置 icon 的颜色

```php
$this->colors(['#F7BA2A', '#F7BA2A', '#F7BA2A']);
```

icon 的颜色。若传入数组，共有 3 个元素，为 3 个分段所对应的颜色；若传入对象，可自定义分段，键名为分段的界限值，键值为对应的颜色，默认值: \['#F7BA2A', '#F7BA2A', '#F7BA2A']。

***

### 设置未选中 icon 的颜色

```php
$this->voidColor('#C6D1DE');
```

未选中 icon 的颜色，默认值: #C6D1DE。

***

### 设置只读时未选中 icon 的颜色

```php
$this->disabledVoidColor('#EFF2F7');
```

只读时未选中 icon 的颜色，默认值: #EFF2F7。

***

### 设置 icon 的类名

```php
$this->iconClasses(['el-icon-star-on', 'el-icon-star-on', 'el-icon-star-on']);
```

icon 的类名。若传入数组，共有 3 个元素，为 3 个分段所对应的类名；若传入对象，可自定义分段，键名为分段的界限值，键值为对应的类名，默认值: \['el-icon-star-on', 'el-icon-star-on', 'el-icon-star-on']。

***

### 设置未选中 icon 的类名

```php
$this->voidIconClass('el-icon-star-off');
```

未选中 icon 的类名，默认值: el-icon-star-off。

***

### 设置只读时未选中 icon 的类名

```php
$this->disabledVoidIconClass('el-icon-star-on');
```

只读时未选中 icon 的类名，默认值: el-icon-star-on。

***

### 设置是否显示辅助文字

```php
$this->showText(true);
```

是否显示辅助文字，若为真，则会从 texts 数组中选取当前分数对应的文字内容，默认值: false。

***

### 设置是否显示当前分数

```php
$this->showScore(true);
```

是否显示当前分数，show-score 和 show-text 不能同时为真，默认值: false。

***

### 设置辅助文字的颜色

```php
$this->textColor('#1F2D3D');
```

辅助文字的颜色，默认值: #1F2D3D。

***

### 设置辅助文字数组

```php
$this->texts(['极差', '失望', '一般', '满意', '惊喜']);
```

辅助文字数组，默认值: \['极差', '失望', '一般', '满意', '惊喜']。

***

### 设置分数显示模板

```php
$this->scoreTemplate('{value}');
```

分数显示模板，默认值: {value}。