uniapp下拉选择组件

uniapp下拉选择组件

背景

最近遇到一个这样的需求,在输入框中输入关键字,通过接口查询到结果之后,以下拉框列表形式展现供用户选择。查询了下uni-app官网和项目中使用的uv-ui库,没找到符合条件的组件。唯一一个有点类似的就是uni官方下拉框组件,但是不支持input组件,所以我们自己来实现一个。

我们先上一张图镇楼,提供了多种模式和使用场景的情况

实现思路

那么实现这样一个组件要有哪些注意点了?我大概罗列了一下:

1、下拉框默认是不显示的,要知道是在哪个位置显示

2、初始显示的组件不能定死,可以是button,可以是view,或者是input,要灵活

3、提供丰富的自定义配置

要解决第一和第二个问题,我们的自定义组件需要使用插槽,插槽用来放我们的初始显示组件,来灵活适配各种组件。然后在插槽下面来通过绝对定位来显示下拉框组件,默认隐藏,然后暴露出显示函数给外部。

代码实现

接下来就是代码实现环节了,有了思路直接按思路撸代码就行。

知道你们不喜欢啰嗦BB,哈哈,直接上代码

(down-select.vue)组件代码:

javascript 复制代码
<template>
	<view class='layout-column'>
		<view id="parent" style="width:fit-content;">
			<slot></slot>
		</view>
		<view
			:style="'width:'+slotW+';max-height: '+getListContentHei+'rpx;z-index: 9999;position: absolute;margin-top:'+slotH+';'+(isShow ? '' : 'display:none;')"
			:class="(dataList.length > 0 ? 'data-box-shadow ' : 'data-box ') + animate">
			<block v-if="dataList.length > 0">
				<view class="data-box-scroll"
					:style="'height:'+dataList.length*(itemHeight-1)+'rpx;max-height: '+max*(itemHeight-1)+'rpx;'">
					<text v-for="(item,index) in dataList" :key="item[identifier]"
						:class="'layout-row less-center list-item '+(item.enable === false ? '' : 'active')"
						:style="'color:'+(item.enable === false ? '#dedede' : (checkedIndex.indexOf(index) >= 0 ? itemSelectColor : itemColor))+';font-size:'+itemFontsize+'rpx;'"
						@click="handleListItem(index, item)">{{item[showKey]}}</text>
				</view>
				<view class="layout-row opera-btns less-center" v-if="mode == 'multiple'">
					<view class="opera-cancel layout-row center" @click='handelCancel'>取消</view>
					<view class="opera-sure layout-row center" @click='handelSure'>确定</view>
				</view>
			</block>
			<view v-else :style="'width:'+slotW+';'" class='status-text'>暂无数据</view>
		</view>
		<view class="mask" v-show="isShow" @click="handelCancel"></view>
	</view>
</template>

<script>
	export default {
		name: "down-select",
		props: {
			//要显示的字段
			showKey: {
				type: String,
				default: '',
			},
			mode: {
				type: String,
				default: 'single', //multiple
				// default: 'multiple'
			},
			dataList: {
				type: Array,
				default: []
			},
			//选中的列表,用作显示列表是展示已选中项
			checkedDataList: {
				type: Array,
				default: []
			},
			//最多展示几项后开始滑动
			max: {
				type: Number,
				default: 4
			},
			//数据项每个item高度rpx
			itemHeight: {
				type: Number,
				default: 80
			},
			//唯一标识符字段,用来比对选中项和维持v-for列表中的key,不填此项无选中效果
			identifier: {
				type: String,
				default: ''
			},
			itemSelectColor: {
				type: String,
				default: '#00aaff'
			},
			itemColor: {
				type: String,
				default: 'black'
			},
			itemFontsize: {
				type: Number,
				default: 30
			}
		},
		computed: {
			getListContentHei() {
				let len = this.dataList.length
				let signleH = len < this.max ? this.itemHeight * len : this.itemHeight * this.max
				if (this.mode == 'single') {
					return len <= 0 ? this.itemHeight : signleH
				} else {
					return len <= 0 ? this.itemHeight : (signleH + this.itemHeight)
				}
			}
		},
		watch: {
			dataList: {
				handler: function(newVal, oldVal) {
					if (this.checkedDataList.length >= 0 && this.identifier) {
						this.checkedIndex = []
						this.checkedDataList.forEach(ele => {
							let index = newVal.findIndex(ele1 => ele[this.identifier] === ele1[this
								.identifier])
							if (index >= 0) {
								this.checkedIndex.push(index)
							}
						})
					}
				},
				immediate: true, // 组件创建时立即触发
				deep: true // 对象内部属性变化时也触发
			},
			checkedDataList: {
				handler: function(newVal, oldVal) {
					if (newVal.length >= 0 && this.identifier) {
						this.checkedIndex = []
						newVal.forEach(ele => {
							let index = this.dataList.findIndex(ele1 => ele[this.identifier] === ele1[this
								.identifier])
							if (index >= 0) {
								this.checkedIndex.push(index)
							}
						})
					}
				},
				immediate: true, // 组件创建时立即触发
				deep: true // 对象内部属性变化时也触发
			}
		},
		mounted() {
			this.$nextTick(() => {
				uni.createSelectorQuery().in(this).select('#parent').boundingClientRect(res => {
					if (res.width) {
						this.slotW = `${res.width}px`
						this.slotH = `${res.height+5}px`
					}
				}).exec()
			})
		},
		data() {
			return {
				slotW: '0px',
				slotH: '0px',
				isShow: false,
				checkedIndex: [],
				animate: '',
				//传进来选中项,后又改成未选中并确认,多选模式生效
				checkedDels: []
			};
		},
		methods: {
			open() {
				if (this.checkedDataList.length >= 0 && this.identifier) {
					this.checkedIndex = []
					this.checkedDataList.forEach(ele => {
						let index = this.dataList.findIndex(ele1 => ele[this.identifier] === ele1[this
							.identifier])
						if (index >= 0) {
							this.checkedIndex.push(index)
						}
					})
				}
				this.isShow = true
				this.animate = 'show-animate'
			},
			close() {
				this.animate = 'hide-animate'
				this.checkedIndex = []
				this.checkedDels = []
				this.isShow = false
			},
			handleListItem(index, obj) {
				if(obj.enable === false){
					return
				}
				if (this.mode === 'single') {
					this.checkedIndex = []
					this.checkedIndex.push(index)
					this.handelSure()
				} else {
					let sindex = this.checkedIndex.indexOf(index)
					if (sindex >= 0) {
						if (this.identifier) {
							//判断未选中的项在传进来的已选项中是否存在
							let contain = this.checkedDataList.filter(ele => ele[this.identifier] === this.dataList[index][
								this.identifier
							])
							if (contain.length > 0) {
								//传进来的已选项中是否存在选择为未选中的内容
								let contain1 = this.checkedDels.filter(ele => ele[this.identifier] === contain[0][this
									.identifier
								])
								if (contain1.length <= 0) {
									this.checkedDels.push(contain[0])
								}
							}
						}
						this.checkedIndex.splice(sindex, 1);
					} else {
						if (this.identifier) {
							let contain2 = this.checkedDels.filter(ele => ele[this.identifier] === this.dataList[index][
								this.identifier
							])
							if (contain2.length > 0) {
								let tempIndex = this.checkedDels.findIndex(ele => ele[this.identifier] === this.dataList[
									index][this.identifier])
								if (tempIndex >= 0) {
									this.checkedDels.splice(tempIndex, 1)
								}
							}
						}
						this.checkedIndex.push(index)
					}
				}
			},
			handelCancel() {
				this.close()
				this.$emit('cancelDimss', '')
			},
			handelSure() {
				let results = []
				if (this.checkedIndex.length <= 0) {
					uni.showToast({
						title: '请选择至少一项',
						icon: 'none'
					});
					return
				}

				this.checkedIndex.forEach(ele => {
					if (this.dataList[ele]) {
						results.push(this.dataList[ele])
					}
				})
				//将本次选中结果清除
				this.checkedIndex = []
				this.$emit('resultBack', results, this.checkedDels)
				this.close()
			}
		}
	}
</script>

<style scoped>
	.active {}

	.active:active {
		opacity: 0.6;
	}

	.layout-row {
		display: flex;
		flex-direction: row;
	}

	.layout-column {
		display: flex;
		flex-direction: column;
	}

	/* 整体方向居中 */
	.center {
		align-items: center;
		justify-content: center;
	}

	/* 主轴方向居中 */
	.main-center {
		justify-content: center;
	}

	/* 侧轴方向居中 */
	.less-center {
		align-items: center;
	}

	.data-box-scroll {
		width: 100%;
		overflow-y: scroll;
	}

	.data-box-scroll::-webkit-scrollbar {
		display: none
	}

	.data-box {
		background: white;
		border-radius: 8rpx;
		box-shadow: 0px 0px 3px 1px rgba(0, 0, 0, 0.1);
		z-index: 9999;
	}

	.data-box-shadow {
		background: white;
		border-radius: 8rpx;
		box-shadow: 0px 0px 3px 1px rgba(0, 0, 0, 0.1);
		z-index: 9999;
	}

	.list-item {
		width: 100%;
		height: 80rpx;
		margin-left: 20rpx;
		margin-right: 20rpx;
		border-bottom: 1rpx solid #D8DFEC;
		text-align: right;
	}

	.opera-btns {
		width: 100%;
		height: 80rpx;
		justify-content: flex-end;
	}

	.opera-cancel {
		width: 100rpx;
		height: 50rpx;
		background-color: white;
		box-shadow: 0px 0px 3px 1px rgba(0, 0, 0, 0.1);
		border-radius: 5rpx;
		font-size: 26rpx;
	}

	.opera-sure {
		width: 100rpx;
		height: 50rpx;
		background-color: #58a2e4;
		box-shadow: 0px 0px 3px 1px rgba(0, 0, 0, 0.1);
		border-radius: 5rpx;
		font-size: 26rpx;
		color: white;
		margin-right: 30rpx;
		margin-left: 30rpx;
	}

	.status-text {
		text-align: center;
		font-size: 28rpx;
		font-weight: 600;
		color: #c2c2c2;
		padding-top: 20rpx;
		padding-bottom: 20rpx;
	}

	.mask {
		position: fixed;
		background: transparent;
		top: 0;
		left: 0;
		width: 100%;
		height: 100%;
		z-index: 1;
	}

	.show-animate {
		animation-name: open;
		animation-duration: 1s;
		animation-iteration-count: 1;
	}

	@keyframes open {
		0% {
			height: 0rpx;
		}

		100% {
			height: 100%;
		}
	}

	.hide-animate {
		animation-name: close;
		animation-duration: 1s;
		animation-iteration-count: 1;
		animation-fill-mode: forwards;
	}

	@keyframes close {
		0% {
			height: 100%;
		}

		100% {
			height: 0rpx;
		}
	}
</style>

(test.vue)测试页面代码:

javascript 复制代码
<template>
	<view class="content">
		<downSelect ref='selectRef' showKey="name" mode='single' :dataList="list" @resultBack="result">
			<view class="select-btn" @click="handleClick">单选默认配置</view>
		</downSelect>
		<view>{{select.name}}</view>

		<downSelect ref='selectRef1' showKey="name" mode='single' itemColor='red' :dataList="list1" @resultBack="result1">
			<view class="select-btn1" @click="handleClick1">单选字体设置,是否可点击</view>
		</downSelect>
		<view>{{select1.name}}</view>

		<downSelect ref='selectRef2' showKey="name" mode='multiple' identifier="id" :dataList="list2"
			:max="5" :itemFontsize='20' :checkedDataList="select2" @resultBack="result2">
			<view class="select-btn2" @click="handleClick2">多选字体大小设置,超出设置项后滑动设置</view>
		</downSelect>
		<view v-for="item in select2">{{item.name}}</view>
		
		<downSelect ref='selectRef3' showKey="name" mode='single'>
			<view class="select-btn2" @click="handleClick3">空数据</view>
		</downSelect>
		
		<downSelect ref='selectRef4' showKey="name" mode='single' :dataList="list4" @resultBack="result4">
			<input class="select-btn1" placeholder="请输入" @input="handleInput"/>
		</downSelect>
		<view>{{select4.name}}</view>
	</view>

</template>

<script>
	import downSelect from "@/components/down-select.vue"
	export default {
		components: {
			downSelect
		},
		data() {
			return {
				select: {},
				select1: {},
				select2: [],
				select4: {},
				list: [{
					name: '选项一'
				}, {
					name: '选项二'
				}],
				list1: [{
					name: '选项一',
					enable: false
				}, {
					name: '选项二'
				}, {
					name: '选项三'
				}, {
					name: '选项四'
				}, {
					name: '选项五'
				}],
				list2: [{
					id: '0',
					name: '选项一'
				}, {
					id: '1',
					name: '选项二'
				}, {
					id: '2',
					name: '选项三'
				}, {
					id: '3',
					name: '选项四'
				}, {
					id: '4',
					name: '选项五'
				}, {
					id: '5',
					name: '选项六'
				}],
				list4: []
			}
		},
		onLoad() {
			
		},
		methods: {
			handleInput(e){
				this.$refs.selectRef4.open()
				//这里模拟接口访问获取数据
				setTimeout(()=> {
					this.list4 = [{
						name: '选项一'
					}, {
						name: '选项二'
					}]
				},2000)
			},
			result(result) {
				this.select = result[0]
			},
			result1(result){
				this.select1 = result[0]
			},
			result2(result, dels = []){
				// this.select2 = result
				if(this.select2.length <= 0){
				  this.select2.push(...result)
				}else {
				  result.forEach(ele => {
				    let contain = this.select2.filter(ele1 => ele.id === ele1.id)
				    if(contain.length <= 0){
				      this.select2.push(ele)
				    }
				  })
				}
				if(dels.length > 0){
				  dels.forEach(ele => {
				    let index = this.select2.findIndex(ele1 => ele1.id === ele.id)
				    if(index >= 0){
				      this.select2.splice(index, 1)
				    }
				  })
				}
			},
			result4(result){
				this.select4 = result[0]
			},
			handleClick(){
				this.$refs.selectRef.open()
			},
			handleClick1() {
				this.$refs.selectRef1.open()
			},
			handleClick2 () {
				this.$refs.selectRef2.open()
			},
			handleClick3 () {
				this.$refs.selectRef3.open()
			}
		},
	}
</script>

<style>
	.content {
		width: 690rpx;
		margin: 25rpx;
	}

	.select-btn {
		width: 690rpx;
		height: 60rpx;
		display: flex;
		flex-direction: row;
		align-items: center;
		justify-content: center;
		border: 1rpx solid #e5e5e5;
		border-radius: 15rpx;
	}

	.select-btn1 {
		width: 490rpx;
		height: 60rpx;
		display: flex;
		margin-top: 100rpx;
		flex-direction: row;
		align-items: center;
		justify-content: center;
		border: 1rpx solid #e5e5e5;
		border-radius: 15rpx;
	}

	.select-btn2 {
		width: 690rpx;
		height: 60rpx;
		display: flex;
		margin-top: 100rpx;
		flex-direction: row;
		align-items: center;
		justify-content: center;
		border: 1rpx solid #e5e5e5;
		border-radius: 15rpx;
	}
</style>

以上代码都可以直接拷贝使用,无其他关联项,vue2、vue3、小程序、h5、APP都可用。

配置项

1、showKey:传进来的数组单个对象在下拉框中要展示的值,比如传的dataList为[{name: '韩梅梅'}],那showKey传name就行。

2、mode:下拉框是单选还是多选模式,见镇楼效果图。

3、dataList:传入的数据列表,列表为对象,多选时对象需要指定唯一标识。

4、checkedDataList:多选选中的列表数据。

5、max:多条数据时最多显示几项后可以滑动。

6、identifier:唯一标识符,用作列表key和多选模式显示已选数据项时的标识。

7、itemSelectColor:多选模式选中后的字体颜色。

8、itemColor:字体颜色。

9、itemFontsize:字体大小。

以上配置项在代码层面没做严格限制,不同模式混用可能会有bug,如果发现可以留言。配置项不满足你需求,可以自行增删。

使用

页面引入down-select.vue,然后参考第二节代码实现中的demo。

尾巴

今天的文章就到这里了,希望能给大家帮助,如果喜欢我的文章,欢迎给我点赞,评论,关注,谢谢大家!

相关推荐
我开心就好o5 小时前
uniapp点左上角返回键, 重复来回跳转的问题 解决方案
前端·javascript·uni-app
Random_index5 小时前
#Uniapp篇:支持纯血鸿蒙&发布&适配&UIUI
uni-app·harmonyos
初遇你时动了情12 小时前
uniapp 城市选择插件
开发语言·javascript·uni-app
小小黑00715 小时前
uniapp+vue3+ts H5端使用Quill富文本插件以及解决上传图片反显的问题
uni-app·vue
草字15 小时前
uniapp input限制输入负数,以及保留小数点两位.
java·前端·uni-app
前端小胡兔16 小时前
uniapp rpx兼容平板
uni-app
荔枝吖16 小时前
uniapp实现开发遇到过的问题(持续更新中....)
uni-app
艾小逗16 小时前
uniapp将图片url转换成base64支持app和h5
uni-app·base64·imagetobase64
halo141618 小时前
uni-app 界面TabBar中间大图标设置的两种方法
开发语言·javascript·uni-app
赣州云智科技的技术铺子2 天前
uni app下开发AI运动小程序解决方案
uni-app·ai运动·ai运动识别·运动识别引擎·uni ai运动解决方案·ai运动会·ai体测