010_Select选择器

1. Select选择器

1.1. 当选项过多时, 使用下拉菜单展示并选择内容。

1.2. Select属性

参数	说明	类型	可选值	默认值
value / v-model	绑定值	boolean / string / number	无	无
multiple	是否多选	boolean	无	false
disabled	是否禁用	boolean	无	false
value-key	作为value唯一标识的键名, 绑定值为对象类型时必填	string	无	value
size	输入框尺寸	string	medium/small/mini	无
clearable	是否可以清空选项	boolean	无	false
collapse-tags	多选时是否将选中值按文字的形式展示	boolean	无	false
multiple-limit	多选时用户最多可以选择的项目数, 为0则不限制	number	无	0
name	select input的name属性	string	无	无
autocomplete	select input的autocomplete属性	string	无	off
placeholder	占位符	string	无	请选择
filterable	是否可搜索	boolean	无	false
allow-create	是否允许用户创建新条目, 需配合filterable使用	boolean	无	false
filter-method	自定义搜索方法	function	无	无
remote	是否为远程搜索	boolean	无	false
remote-method	远程搜索方法	function	无	无
loading	是否正在从远程获取数据	boolean	无	false
loading-text	远程加载时显示的文字	string	无	加载中
no-match-text	搜索条件无匹配时显示的文字, 也可以使用slot="empty"设置	string	无	无匹配数据
no-data-text	选项为空时显示的文字, 也可以使用slot="empty"设置	string	无	无数据
popper-class	Select下拉框的类名	string	无	无
reserve-keyword	多选且可搜索时, 是否在选中一个选项后保留当前的搜索关键词	boolean	无	false
default-first-option	在输入框按下回车, 选择第一个匹配项。需配合filterable或remote使用	boolean	无	false
popper-append-to-body	是否将弹出框插入至body元素。在弹出框的定位出现问题时, 可将该属性设置为false	boolean	无	true
automatic-dropdown	对于不可搜索的Select, 是否在输入框获得焦点后自动弹出选项菜单	boolean	无	false

1.3. Select事件

事件名称	说明	回调参数
change	选中值发生变化时触发	目前的选中值
visible-change	下拉框出现/隐藏时触发	出现则为true, 隐藏则为false
remove-tag	多选模式下移除tag时触发	移除的tag值
clear	可清空的单选模式下用户点击清空按钮时触发	无
blur	当input失去焦点时触发	(event: Event)
focus	当input获得焦点时触发	(event: Event)

1.4. Select Slots

name	说明
—	Option组件列表
prefix	Select组件头部内容
empty	无选项时的列表

1.5. Option Group属性

参数	说明	类型	默认值
label	分组的组名	string	无
disabled	是否将该分组下所有选项置为禁用	boolean	false

1.6. Option属性

参数	说明	类型	默认值
value	选项的值	string/number/object	无
label	选项的标签, 若不设置则默认与value相同	string/number	无
disabled	是否禁用该选项	boolean	false

1.7. 方法

事件名称	说明
focus	在Input获得焦点
blur	使input失去焦点, 并隐藏下拉框

2. Select选择器例子

2.1. 使用脚手架新建一个名为element-ui-select的前端项目, 同时安装Element插件。

2.2. 编辑index.js 

import Vue from 'vue'
import VueRouter from 'vue-router'
import Select from '../components/Select.vue'
import MultipleSelect from '../components/MultipleSelect.vue'
import SearchSelect from '../components/SearchSelect.vue'
import RemoteSearchSelect from '../components/RemoteSearchSelect.vue'
import CreateSelect from '../components/CreateSelect.vue'

Vue.use(VueRouter)

const routes = [
  { path: '/', redirect: '/Select' },
  { path: '/Select', component: Select },
  { path: '/MultipleSelect', component: MultipleSelect },
  { path: '/SearchSelect', component: SearchSelect },
  { path: '/RemoteSearchSelect', component: RemoteSearchSelect },
  { path: '/CreateSelect', component: CreateSelect }
]

const router = new VueRouter({
  routes
})

export default router

2.3. 在components下创建Select.vue

<template>
  <div>
    <h1>基础用法-适用广泛的基础单选</h1>
    <h4>v-model的值为当前被选中的el-option的value属性值。</h4>
    <el-select v-model="base_value" placeholder="请选择">
      <el-option v-for="item in base_options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>

    <h1>有禁用选项</h1>
    <h4>在el-option中, 设定disabled值为true, 即可禁用该选项。</h4>
    <el-select v-model="disabled_value" placeholder="请选择">
      <el-option v-for="item in disabled_options" :key="item.value" :label="item.label" :value="item.value" :disabled="item.disabled"></el-option>
    </el-select>

    <h1>禁用状态-选择器不可用状态</h1>
    <h4>为el-select设置disabled属性, 则整个选择器不可用。</h4>
    <el-select v-model="value" disabled placeholder="请选择">
      <el-option v-for="item in options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>

    <h1>可清空单选</h1>
    <h4>为el-select设置clearable属性, 则可将选择器清空。需要注意的是, clearable属性仅适用于单选。</h4>
    <el-select v-model="clearable_value" clearable placeholder="请选择">
      <el-option v-for="item in clearable_options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>
  </div>
</template>

<script>
export default {
  data () {
    return {
      base_options: [{
        value: '选项1',
        label: '黄金糕'
      }, {
        value: '选项2',
        label: '双皮奶'
      }, {
        value: '选项3',
        label: '蚵仔煎'
      }, {
        value: '选项4',
        label: '龙须面'
      }, {
        value: '选项5',
        label: '北京烤鸭'
      }],
      base_value: '',
      disabled_options: [{
        value: '选项1',
        label: '黄金糕'
      }, {
        value: '选项2',
        label: '双皮奶',
        disabled: true
      }, {
        value: '选项3',
        label: '蚵仔煎'
      }, {
        value: '选项4',
        label: '龙须面'
      }, {
        value: '选项5',
        label: '北京烤鸭'
      }],
      disabled_value: '',
      options: [{
        value: '选项1',
        label: '黄金糕'
      }, {
        value: '选项2',
        label: '双皮奶'
      }, {
        value: '选项3',
        label: '蚵仔煎'
      }, {
        value: '选项4',
        label: '龙须面'
      }, {
        value: '选项5',
        label: '北京烤鸭'
      }],
      value: '',
      clearable_options: [{
        value: '选项1',
        label: '黄金糕'
      }, {
        value: '选项2',
        label: '双皮奶'
      }, {
        value: '选项3',
        label: '蚵仔煎'
      }, {
        value: '选项4',
        label: '龙须面'
      }, {
        value: '选项5',
        label: '北京烤鸭'
      }],
      clearable_value: ''
    }
  }
}
</script>

2.4. 在components下创建MultipleSelect.vue

<template>
  <div>
    <h1>基础多选-适用性较广的基础多选, 用Tag展示已选项</h1>
    <h4>为el-select设置multiple属性即可启用多选, 此时v-model的值为当前选中值所组成的数组。默认情况下选中值会以Tag的形式展现, 你也可以设置collapse-tags属性将它们合并为一段文字。</h4>
    <el-select v-model="value1" multiple placeholder="请选择">
      <el-option v-for="item in options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>

    <el-select v-model="value2" multiple collapse-tags style="margin-left: 20px;" placeholder="请选择">
      <el-option v-for="item in options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>

    <h1>自定义模板-可以自定义备选项</h1>
    <h4>将自定义的HTML模板插入el-option的slot中即可。</h4>
    <el-select v-model="value" placeholder="请选择">
      <el-option v-for="item in cities" :key="item.value" :label="item.label" :value="item.value">
        <span style="float: left">{{ item.label }}</span>
        <span style="float: right; color: #8492a6; font-size: 13px">{{ item.value }}</span>
      </el-option>
    </el-select>

    <h1>分组-备选项进行分组展示</h1>
    <h4>使用el-option-group对备选项进行分组, 它的label属性为分组名。</h4>
    <el-select v-model="group_value" placeholder="请选择">
      <el-option-group v-for="group in group_options" :key="group.label" :label="group.label">
        <el-option v-for="item in group.options" :key="item.value" :label="item.label" :value="item.value"></el-option>
      </el-option-group>
    </el-select>
  </div>
</template>

<script>
export default {
  data () {
    return {
      options: [{
        value: '选项1',
        label: '黄金糕'
      }, {
        value: '选项2',
        label: '双皮奶'
      }, {
        value: '选项3',
        label: '蚵仔煎'
      }, {
        value: '选项4',
        label: '龙须面'
      }, {
        value: '选项5',
        label: '北京烤鸭'
      }],
      value1: [],
      value2: [],
      cities: [{
        value: 'Beijing',
        label: '北京'
      }, {
        value: 'Shanghai',
        label: '上海'
      }, {
        value: 'Nanjing',
        label: '南京'
      }, {
        value: 'Chengdu',
        label: '成都'
      }, {
        value: 'Shenzhen',
        label: '深圳'
      }, {
        value: 'Guangzhou',
        label: '广州'
      }],
      value: '',
      group_options: [{
        label: '热门城市',
        options: [{
          value: 'Shanghai',
          label: '上海'
        }, {
          value: 'Beijing',
          label: '北京'
        }]
      }, {
        label: '城市名',
        options: [{
          value: 'Chengdu',
          label: '成都'
        }, {
          value: 'Shenzhen',
          label: '深圳'
        }, {
          value: 'Guangzhou',
          label: '广州'
        }, {
          value: 'Dalian',
          label: '大连'
        }]
      }],
      group_value: ''
    }
  }
}
</script>

2.5. 在components下创建SearchSelect.vue

<template>
  <div>
    <h1>可搜索-可以利用搜索功能快速查找选项</h1>
    <h4>为el-select添加filterable属性即可启用搜索功能。默认情况下, Select会找出所有label属性包含输入值的选项。如果希望使用其他的搜索逻辑, 可以通过传入一个filter-method来实现。filter-method为一个Function, 它会在输入值发生变化时调用, 参数为当前输入值。</h4>
    <el-select v-model="value" filterable placeholder="请选择" :filter-method="filterMethod">
      <el-option v-for="item in options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>
  </div>
</template>

<script>
export default {
  data () {
    return {
      options: [{
        value: '选项1',
        label: '黄金糕'
      }, {
        value: '选项2',
        label: '双皮奶'
      }, {
        value: '选项3',
        label: '蚵仔煎'
      }, {
        value: '选项4',
        label: '龙须面'
      }, {
        value: '选项5',
        label: '北京烤鸭'
      }],
      value: ''
    }
  },
  methods: {
    filterMethod (query) {
      console.log(query)
    }
  }
}
</script>

2.6. 在components下创建RemoteSearchSelect.vue

<template>
  <div>
    <h1>远程搜索-从服务器搜索数据, 输入关键字进行查找</h1>
    <h4>为了启用远程搜索, 需要将filterable和remote设置为true, 同时传入一个remote-method。remote-method为一个Function, 它会在输入值发生变化时调用, 参数为当前输入值。需要注意的是, 如果el-option是通过v-for指令渲染出来的, 此时需要为el-option添加key属性, 且其值需具有唯一性, 比如此例中的item.value。</h4>
    <el-select v-model="value" multiple filterable remote reserve-keyword placeholder="请输入关键词" :remote-method="remoteMethod" :loading="loading">
      <el-option v-for="item in options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>
  </div>
</template>

<script>
export default {
  data () {
    return {
      options: [],
      value: [],
      list: [],
      loading: false,
      states: [
        'Alabama', 'Alaska', 'Arizona', 'Arkansas', 'California', 'Colorado', 'Connecticut', 'Delaware', 'Florida', 'Georgia', 'Hawaii', 'Idaho', 'Illinois',
        'Indiana', 'Iowa', 'Kansas', 'Kentucky', 'Louisiana', 'Maine', 'Maryland', 'Massachusetts', 'Michigan', 'Minnesota', 'Mississippi', 'Missouri', 'Montana',
        'Nebraska', 'Nevada', 'New Hampshire', 'New Jersey', 'New Mexico', 'New York', 'North Carolina', 'North Dakota', 'Ohio', 'Oklahoma', 'Oregon', 'Pennsylvania',
        'Rhode Island', 'South Carolina', 'South Dakota', 'Tennessee', 'Texas', 'Utah', 'Vermont', 'Virginia', 'Washington', 'West Virginia', 'Wisconsin', 'Wyoming'
      ]
    }
  },
  mounted () {
    this.list = this.states.map(item => {
      return { value: `value:${item}`, label: `label:${item}` }
    })
  },
  methods: {
    remoteMethod (query) {
      if (query !== '') {
        this.loading = true
        setTimeout(() => {
          this.loading = false
          this.options = this.list.filter(item => {
            return item.label.toLowerCase()
              .indexOf(query.toLowerCase()) > -1
          })
        }, 200)
      } else {
        this.options = []
      }
    }
  }
}
</script>

2.7. 在components下创建CreateSelect.vue

<template>
  <div>
    <h1>创建条目-可以创建并选中选项中不存在的条目</h1>
    <h4>使用allow-create属性即可通过在输入框中输入文字来创建新的条目。注意此时filterable必须为真。本例还使用了default-first-option属性, 在该属性打开的情况下, 按下回车就可以选中当前选项列表中的第一个选项, 无需使用鼠标或键盘方向键进行定位。</h4>
    <el-select v-model="value" multiple filterable allow-create default-first-option placeholder="请选择文章标签">
      <el-option v-for="item in options" :key="item.value" :label="item.label" :value="item.value"></el-option>
    </el-select>
  </div>
</template>

<script>
export default {
  data () {
    return {
      options: [{
        value: 'HTML',
        label: 'HTML'
      }, {
        value: 'CSS',
        label: 'CSS'
      }, {
        value: 'JavaScript',
        label: 'JavaScript'
      }],
      value: []
    }
  }
}
</script>

2.8. 运行项目, 访问http://localhost:8080/#/Select

2.9. 运行项目, 访问http://localhost:8080/#/MultipleSelect 

2.10. 运行项目, 访问http://localhost:8080/#/SearchSelect 

2.11. 运行项目, 访问http://localhost:8080/#/RemoteSearchSelect

2.12. 运行项目, 访问http://localhost:8080/#/CreateSelect