mirror of https://github.com/ElemeFE/element
2.6 KiB
2.6 KiB
element-select
A element-select component for Vue.js.
dependencies
- vue-clickoutside
Installation
npm i element-select -D
Usage
import vue from 'Vue'
// import component
import Component from 'element-select'
import 'element-select/lib/style.css'
Vue.use(Component)
or
import { ElSelect, ElOption, ElOptionGroup } from 'element-select'
Vue.component('el-select', ElSelect)
Vue.component('el-option', ElOption)
Vue.component('el-option-group', ElOptionGroup)
Select Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
multiple | 是否多选 | boolean | — | false |
disabled | 是否禁用 | boolean | — | false |
size | 输入框尺寸 | string | large/small/mini | — |
clearable | 单选时是否可以清空选项 | boolean | — | false |
multiple-limit | 多选时用户最多可以选择的项目数,为 0 则不限制 | number | — | 0 |
name | select input 的 name 属性 | string | — | — |
placeholder | 占位符 | string | — | 请选择 |
filterable | 是否可搜索 | boolean | — | false |
allow-create | 是否允许用户创建新条目,需配合 filterable 使用 |
boolean | — | false |
filter-method | 自定义过滤方法 | function | — | — |
remote | 是否为远程搜索 | boolean | — | false |
remote-method | 远程搜索方法 | function | — | — |
loading | 是否正在从远程获取数据 | boolean | — | false |
Select Events
事件名称 | 说明 | 回调参数 |
---|---|---|
change | 选中值发生变化时触发 | 目前的选中值 |
Option Group Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
label | 分组的组名 | string | — | — |
disabled | 是否将该分组下所有选项置为禁用 | boolean | — | false |
Option Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
value | 选项的值 | string/number/object | — | — |
label | 选项的标签,若不设置则默认与 value 相同 |
string/number | — | — |
disabled | 是否禁用该选项 | boolean | — | false |
Development
make dev
## test
make test
## build
make build