Skip to content

Select 组件

ElementPlus Select 组件

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

方法说明

设置是否多选

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。