更新记录
0.0.2(2023-06-06)
优化使用文档
0.0.1(2023-06-06)
一个基于Vue3和TypeScript开发的 Area 省市区三级联动选择组件。
平台兼容性
Vue2 | Vue3 |
---|---|
× | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 3.7.11 app-vue | × | √ | √ | × | × | √ |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
√ | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | × | × | × | × | × |
组件库官方文档:fant-mini-plus
组件库提供更多vue3组件,比单独引入更加强大
Area 省市区选择
省市区三级联动选择。
代码演示
基础用法
下面演示了省市区选择组件的用法,省市区选择完成后会触发 confirm
事件,返回值为省市区三项的数组。
首先安装vant提供的省市区数据源
yarn add @vant/area-data
<hd-area :area-data="areaData" :area="areaSelect" @confirm="doConfirm"></hd-area>
<script lang="ts" setup>
import { areaList } from '@vant/area-data'
import { ref } from 'vue'
import { useArea } from '@/uni_modules/hd-area/components/hd-area';
const areaData = ref(areaList) // 位置信息数据
const areaSelect = ref<any[]>([]) // 已选省市区
const area = useArea()
function showArea() {
area.showArea()
}
/**
* 省市区选择成功
* @param select 选择的省市区
*/
function doConfirm(select: Ucn[]) {
areaSelect.value = select
}
</script>
Props
Name | Description | Type | Required | Default |
---|---|---|---|---|
areaData | 省市区数据 | Object |
false |
- |
area | 当前选中的省市区 | Array |
false |
[] |
id | 组件唯一标识 | String |
false |
- |
Events
Event Name | Description | Parameters |
---|---|---|
close | 地区选择器关闭时触发 | - |
confirm | 地址选择完成后触发 | value: 当前选中的省市区 Ucn[] |
联系方式
有不明白或者建议可以扫码交流