mirror of
https://github.com/WeBankFinTech/fes.js.git
synced 2025-04-06 03:59:53 +08:00
7.1 KiB
7.1 KiB
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 |