# tui-dropdown-list 下拉列表

介绍

下拉列表,下拉选择框。

# 引入

# uni-app引入

第一种,手动引入(可全局引入)

import tuiDropdownList from "@/components/thorui/tui-dropdown-list/tui-dropdown-list.vue"
export default {
	components:{
		tuiDropdownList
	}
}

第二种,开启easycom组件模式,如果不了解如何配置,可先查看 官网文档 (opens new window)

# uni-app版本平台差异说明

App-Nvue App-vue H5 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
升级中

# 微信小程序引入(可在app.json中全局引入)

{
  "usingComponents": {
    "tui-dropdown-list": "/components/thorui/tui-dropdown-list/tui-dropdown-list"
  }
}

# 代码演示

部分功能演示,具体可参考示例程序以及文档API。

基础使用

通过 show 属性控制下拉列表的显示隐藏, top 属性设置下拉列表的top值,一般为 selectionbox 内容高度,height 属性设置下拉列表的高度。

<!--uni-app-->
<tui-dropdown-list :show="dropdownShow" :top="94" :height="400">
	<template v-slot:selectionbox>
		点击选择内容块
	</template>
	<template v-slot:dropdownbox>
		下拉列表内容
	</template>
</tui-dropdown-list>

<!--微信小程序-->
<tui-dropdown-list show="{{dropdownShow}}" top="{{94}}" height="{{400}}">
	<view slot="selectionbox">
		点击选择内容块
	</view>
	<view slot="dropdownbox">
		下拉列表内容
	</view>
</tui-dropdown-list>

# Slots

名称 说明
selectionbox 点击选择内容块,点击内容区整体放入此插槽内
dropdownbox 下拉列表内容,内容多可结合 scroll-view使用

# Props

参数 类型 说明 默认值
show Boolean 控制显示 false
backgroundColor String 背景颜色 transparent
top Number 下拉框top值 单位rpx 0
height Number 下拉框高度 单位rpx 0
selectHeight Number 下拉框父容器高度 单位rpx 0:表示auto
isMask V2.10+ Boolean 下拉框显示时是否显示遮罩 false
maskBackground V2.10+ String 下拉框遮罩背景色 transparent

# Events

注意:uniapp端使用@close,微信小程序端使用bindclose绑定事件。

事件名 说明 回调参数
close V2.10+ 点击遮罩时触发,关闭逻辑需要自行在页面处理 -

# 预览

# 线上程序扫码预览

ThorUI组件库 H5二维码 ThorUI示例
ThorUI组件库小程序码 H5二维码 ThorUI示例小程序码