2020-09-28 11:06:33 +08:00

7.1 KiB
Raw Blame History

pageClass
comp-page-class

Select 选择器

概述

使用模拟的增强下拉选择器来代替浏览器原生的选择器。

代码示例

上海市 深圳市 杭州市 南京市 重庆市

Wb-select内部嵌套Wb-option使用类似原生select内部嵌套option

Wb-selec默认宽度是100%

设置Wb-option为disabled表示禁用此选项

当选择一项时触发on-change事件

上海市 深圳市 杭州市 南京市 重庆市

添加multiple属性value值必须是数组

可以通过multipleLimit属性来控制最多选择几个默认为0

北京市 上海市 深圳市 杭州市 南京市 重庆市 {{item}}

设置filterable属性则选项可以根据输入的内容筛选。

通过on-search监听输入的内容在回调更新option选项数据

将列表数据通过options传入可以达到高性能渲染1万+的数据也不卡

optionsValueName配置传入数据中value的字段名

optionsTextName配置传入数据中text的字段名

API

Select Props

属性 说明 类型 默认值
value 输入的值, 可以使用v-model实现数据的双向绑定 Number, String, File ''
placeholder 提示语 String ''
disabled 是否禁止输入 Boolean false
readonly 是否只读 Boolean false
clearable 是否显示清空按钮 Boolean false
filterable 是否可筛选 Boolean false
multiple 是否多选 Boolean false
multipleLimit 仅多选时使用限制选择数默认值0不限制选择个数 Number 0
options 配置选项的数据 Array null
optionsValueName 指定选项对象的那个字段为值 String 'value'
optionsTextName 指定选项对象的那个字段为text String 'text'

Select Events

事件名 说明 返回值
on-search 当设置filterable为true输入过滤条件时触发。连续输入不触发自带200毫秒的debounce (value, event) => void
on-change 值改变时触发 (value, event) => void

Option Props

属性 说明 类型 默认值
value 选项的值 Number, String ''
label 选项的内容 String ''
disabled 是否禁止选中 Boolean false