更新记录
1.0.10(2022-10-19)
下载此版本
- 修改文档,更改为不兼容小程序(存在下拉框滑动会自动关闭的问题,后期改进后再兼容,若各位有好的解决方法的话欢迎评论)
1.0.9(2022-07-28)
下载此版本
1.0.8(2022-07-26)
下载此版本
- 新增禁用选项和是否创建新条目功能,新增disabledColor和isAllowCreate属性
查看更多
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
× |
× |
× |
× |
× |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
基本用法
在 template
中使用组件
<template>
<view class="content">
<span class="title">非JSON数组模式</span>
<superwei-combox :candidates="candidates" placeholder="请选择或输入" v-model="inputValue" @input="input"
@select="select"></superwei-combox>
<span class="title">JSON数组模式</span>
<superwei-combox :candidates="candidates_json" :isJSON="true" keyName="name" placeholder="请选择或输入"
v-model="inputValue_json" @input="input_json" @select="select_json"></superwei-combox>
</view>
</template>
<script>
export default {
data() {
return {
inputValue: '',
candidates: ['选项一', '选项二', '选项三', '选项四', '选项五', '选项六', '...'],
inputValue_json: '',
candidates_json: [{
id: '1',
name: '选项一'
}, {
id: '2',
name: '选项二',
disabled: true // 单独设置disabled后即可禁用该选项
}, {
id: '3',
name: '选项三'
}, {
id: '4',
name: '选项四'
}, {
id: '5',
name: '选项五',
disabled: true // 单独设置disabled后即可禁用该选项
}, {
id: '6',
name: '...'
}]
}
},
methods: {
input(e) {
console.log(e) // 选项一
},
select(e) {
console.log(e) // 选项一
},
input_json(e) {
console.log(e) // 选项一
},
select_json(e) {
console.log(e) // {id: '1',name: '选项一'}
}
}
}
</script>
<style>
.content {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
}
.title {
margin-top: 20px;
}
</style>
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选项值 |