更新记录

1.0.9(2022-07-28)

  • 完善是否创建新条目功能,并将默认值改为允许

1.0.8(2022-07-26)

  • 新增禁用选项和是否创建新条目功能,新增disabledColor和isAllowCreate属性
查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

基本用法

template 中使用组件

<superwei-combox :candidates="candidates" placeholder="请选择或输入" v-model="inputValue" @input="input" @select="select"></superwei-combox>
<script>
    export default {
        data() {
            return {
                candidates: ['选项一','选项二','选项三','选项四','...']
            }
        },
        methods: {
            input(e){
                console.log(e) // 选项一
            },
            select(e){
                console.log(e) // 选项一
            }
        }
    }
</script>

<superwei-combox :candidates="candidates" :isJSON="true" keyName="name" placeholder="请选择或输入" v-model="inputValue" @input="input" @select="select"></superwei-combox>
<script>
    export default {
        data() {
            return {
                candidates: [{
                    id: '1',
                    name: '选项一'
                }, {
                    id: '2',
                    name: '选项二',
                    disabled: true // 单独设置disabled后即可禁用该选项
                }, {
                    id: '3',
                    name: '...'
                }]
            }
        },
        methods: {
            input(e){
                console.log(e) // 选项一
            },
            select(e){
                console.log(e) // {id: '1',name: '选项一'}
            }
        }
    }
</script>

API

Combox Props

属性名 类型 默认值 说明
label String - 标签文字
value String - combox的值
labelWidth String auto 标签宽度,有单位字符串,如:'100px'
placeholder String - 输入框占位符
candidates Array/String [] 候选字段
emptyTips String 无匹配项 无匹配项时的提示语
selectedBackground String #f5f7fa 选中项背景颜色
selectedColor String #409eff 选中项文字颜色
isJSON Boolean false 候选字段是否是json数组
keyName String - json数组显示的字段值
disabledColor String #ababac 禁用项文字颜色
isAllowCreate Boolean true 是否允许用户创建新条目

Combox Events

事件称名 说明 返回值
@input combox输入事件 返回combox输入值
@select combox选择事件 返回combox选项值

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问