更新记录
1.1(2023-08-17)
下载此版本
修复多选显示问题
1.0.1(2023-08-17)
下载此版本
1.0
平台兼容性
uni-app
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| √ |
√ |
√ |
√ |
√ |
√ |
- |
- |
- |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
| √ |
√ |
√ |
√ |
- |
- |
- |
√ |
- |
√ |
√ |
其他
阿里矢量图-图标组件
组件名:al-icon
安装方式
本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册components。
本组件是jp-select 升级组件,该组件能满足大多数开发需求
拥有 单选、多选、搜索、弹框选择、多选拼接展示...采用v-model双向绑定操作,用户使用更加方便
用法
<template>
<view class="content">
<view class="hader">基础用法</view>
<jp-select-plus label="单选不带搜索" placeholder="请选择" v-model="va1" :list="listc"></jp-select-plus>
<jp-select-plus label="单选带搜索设置主题色" color="#f00"placeholder="请选择" isSearch v-model="va1" :list="listc"></jp-select-plus>
<jp-select-plus label="多选带搜索-排列展示结果" placeholder="请选择" checkbox isSearch v-model="va2" :list="listc"></jp-select-plus>
<jp-select-plus label="多选带搜索-拼接展示结果" placeholder="请选择" isJoin checkbox isSearch v-model="va2" :list="listc"></jp-select-plus>
<jp-select-plus label="一行选择框" :isLineFeed="false" placeholder="请选择" isSearch v-model="va1" :list="listc"></jp-select-plus>
<jp-select-plus label="改变选择主题颜色" placeholder="请选择" isSearch v-model="va1" :list="listc"></jp-select-plus>
<view class="hader">进阶用法</view>
<jp-select-plus @onOpen="getList()" @onSearch="getList()" label="点击后才去后端拿数据,展示加载中" isSearchFun isLoading placeholder="请选择" isSearch v-model="va1" :list="list2"></jp-select-plus>
<view class="hader">只使用弹框</view>
<view class="but" @click="toOpen">
点击开启弹框选择数据
</view>
选中的数据:{{va3}}
<jp-select-plus ref="selectPlus" :isShow="false" v-model="va3" :list="listc"></jp-select-plus>
</view>
</template>
<script>
export default {
data() {
return {
va1: '',
va2: [],
va3: '',
listc: [{
code: 'CHN',
name: '中国'
}, {
name: '美国5',
code: 'USA'
}, {
name: '巴西',
code: 'BRA'
}, {
name: '日本',
code: 'JPN'
}, {
name: '英国',
code: 'ENG'
}, {
name: '法国',
code: 'FRA'
}, {
name: '小人国',
code: 'xr1'
}, {
name: '大人国',
code: 'xr2'
}, {
name: '中人国中人国中人国中人国中人国中人国中人国中人国中人国中人国中人国',
code: 'xr3'
}],
list2:[]
}
},
methods: {
toOpen(){
this.$refs.selectPlus.open()
},
getList(){
let that = this
setTimeout(()=>{
that.list2 = that.listc
},2000)
}
}
}
</script>
<style scoped lang="scss">
.content {
padding: 0 20px;
.but{
margin: 10rpx 25rpx;
background-color: #00aaff;
color: #fff;
text-align: center;
line-height: 80rpx;
}
.hader {
line-height: 80rpx;
font-weight: 800;
}
}
</style>
API
参数
| 属性名 |
类型 |
默认值 |
说明 |
| list |
Array |
|
需要选择的数据(如果是对象需要配置 keys 和 showName 具体说明如下 ) |
| keys |
String |
code |
需要识别的code标识 |
| showName |
String |
name |
需要展示标识 |
| v-model |
|
|
双向绑定 |
| value |
[String, Array] |
|
初始值,多选时必须为数组 |
| label |
String |
|
label名称 |
| labelColor |
String |
#646566 |
label颜色 |
| labelWidth |
String |
'90px' |
label宽度(当选项为一行时生效) |
| placeholder |
String |
'请选择' |
placeholder |
| placeholderColor |
String |
'#999' |
placeholder字体颜色 |
| isLineFeed |
Boolean |
true |
选项框是否为一行,默认独立开 |
| required |
Boolean |
false |
是否显示必填 |
| direction |
String |
left |
文字方向 默认左对齐 |
| color |
String |
'#00aaff' |
主题色 |
| alls |
Boolean |
false |
是否数据全部返回 |
| isoverflow |
Boolean |
false |
超出隐藏 |
| isJoin |
Boolean |
false |
多选时是否拼接展示 |
| isLine |
Boolean |
true |
底部是否有线条 |
| disabled |
Boolean |
fasle |
是否可以选择 |
弹框参数
| 属性名 |
类型 |
默认值 |
说明 |
| title |
String |
请选择 |
弹框名称 |
| cancelText |
String |
取消 |
取消文字 |
| confirmText |
String |
确定 |
确定文字 |
| isSearch |
Boolean |
fasle |
是否开启头部搜索 |
| isSearchFun |
Boolean |
fasle |
点击头部搜索是是否调用外部方法 |
| isLoading |
Boolean |
fasle |
是否显示加载中 |
事件
| 事件名 |
类型 |
回调参数 |
说明 |
| input |
function |
当前选择的数据 key 数组 |
|
| toConfirm |
function |
当前选择的数据 全数据 |
点击确认 |
| onOpen |
function |
无 |
点击选择框时回调 |
| cancel |
function |
无 |
点击取消 |
| input |
function |
无 |
e 当前选择的数据 key 数组 |
方法
| 方法名 |
说明 |
| open() |
打开弹框 |
| close() |
关闭弹框 |