---
url: /docs/forms/components/select.md
---
# Select 组件

[ElementPlus Select 组件](https://element-plus.org/zh-CN/component/select.html)

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

# 方法说明

### 设置是否多选

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

是否多选。

***

### 设置禁用状态

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

是否禁用，默认值: false。

***

### 设置唯一标识的键名

```php
$this->valueKey('id');
```

作为 value 唯一标识的键名，绑定值为对象类型时必填。

***

### 设置输入框尺寸

```php
$this->size('medium');
```

输入框尺寸，可选值: medium / small / mini。

***

### 设置是否可以清空选项

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

是否可以清空选项，默认值: false。

***

### 设置多选模式下是否折叠 Tag

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

多选模式下是否折叠 Tag，默认值: false。

***

### 设置多选时用户最多可以选择的项目数

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

多选时用户最多可以选择的项目数，为 0 则不限制。

***

### 设置 select input 的 name 属性

```php
$this->name('mySelect');
```

select input 的 name 属性。

***

### 设置 select input 的 autocomplete 属性

```php
$this->autocomplete('on');
```

select input 的 autocomplete 属性。

***

### 设置占位符

```php
$this->placeholder('请选择');
```

占位符。

***

### 设置是否可搜索

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

是否可搜索，默认值: false。

***

### 设置是否允许用户创建新条目

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

是否允许用户创建新条目，需配合 filterable 使用，默认值: false。

***

### 设置是否为远程搜索

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

是否为远程搜索，默认值: false。

***

### 设置是否正在从远程获取数据

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

是否正在从远程获取数据，默认值: false。

***

### 设置远程加载时显示的文字

```php
$this->loadingText('加载中...');
```

远程加载时显示的文字。

***

### 设置搜索条件无匹配时显示的文字

```php
$this->noMatchText('无匹配结果');
```

搜索条件无匹配时显示的文字。

***

### 设置选项为空时显示的文字

```php
$this->noDataText('无可选项');
```

选项为空时显示的文字。

***

### 设置 Select 下拉框的类名

```php
$this->popperClass('custom-class');
```

Select 下拉框的类名。

***

### 设置多选且可搜索时是否保留当前的搜索关键词

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

多选且可搜索时，是否在选中一个选项后保留当前的搜索关键词，默认值: false。

***

### 设置在输入框按下回车选择第一个匹配项

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

在输入框按下回车，选择第一个匹配项。需配合 filterable 或 remote 使用，默认值: false。

***

### 设置是否将弹出框插入至 body 元素

```php
$this->popperAppendToBody(false);
```

是否将弹出框插入至 body 元素。在弹出框的定位出现问题时，可将该属性设置为 false，默认值: true。

***

### 设置是否在输入框获得焦点后自动弹出选项菜单

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

对于不可搜索的 Select，是否在输入框获得焦点后自动弹出选项菜单，默认值: false。