更新记录

1.1.7(2024-10-29) 下载此版本

修复底部露出部分组件bug

1.1.6(2024-08-20) 下载此版本

更新本地数据源为最新数据源

1.1.5(2024-06-12) 下载此版本

使用说明文档优化

查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

1.0.7(2023-09-15)

改为uni_modules规范

cityPicker 省市区选择器(兼容vue3)

使用方法:

<template>
    <view>
        <button @tap="open">打开</button>
        <cityPicker :column="column" :default-value="defaultValue" :mask-close-able="maskCloseAble" @confirm="confirm" @cancel="cancel" :visible="visible"/>
        <view>{{str}}</view>
    </view>
</template>

<script>
    import cityPicker from '@/uni_modules/piaoyi-cityPicker/components/piaoyi-cityPicker/piaoyi-cityPicker'
    export default {
        data() {
            return {
                visible: false,
                maskCloseAble: true,
                str: '',
                defaultValue: '420103',
                // defaultValue: ['河北省','唐山市','丰南区'],
                column: 3
            }
        },
        components: {
            cityPicker
        },
        methods: {
            open () {
                this.visible = true
            },
            confirm (val) {
                console.log(val)
                this.str = JSON.stringify(val)
                this.visible = false
            },
            cancel () {
                this.visible = false
            }
        },
        onShareAppMessage(res) {
            if (res.from === 'button') { // 来自页面内分享按钮
                console.log(res.target)
            }
            return {
                title: 'data-cityPicker省市区地址选择器!',
                path: '/pages/cityPicker/cityPicker'
            }
        },
        onShareTimeline(res) {
            if (res.from === 'button') { // 来自页面内分享按钮
                console.log(res.target)
            }
            return {
                title: 'data-cityPicker省市区地址选择器!'
            }
        }
    }
</script>

<style lang="scss">

</style>

注:近期收到使用用户反馈,存在以下一个问题(如有好的建议,期待私信,谢谢)

1、之前只支持默认值传入地区编码,已更新可以支持传入中文省市区数组

defaultValue可以传入defaultValue:['河北省','唐山市','丰南区']数组类型以及defaultValue: '420103'地区编码字符串类型

可以使用const reg =/([\u4e00-\u9fa5]+省|自治区|[\u4e00-\u9fa5]+市|[\u4e00-\u9fa5]+区)/g;将自己的省市区数据进行处理为数组再传入

2、有些用户反馈vue3下watch监听有问题

我自己创建一个vue项目,导入插件后,按照示例原封不动进行测试,没有发现问题; 发现有问题的朋友可以提供一下可以复现的demo给我,我这边看看具体什么情况

3、有些用户返回无法关闭弹框

不要把插件放到scroll-view里面,请务必放到最外层进行使用

事件说明

事件名 返回值 描述
@confirm 对象(code,完整地区名称) 点击确定的回调
@cancel 点击取消的回调

Prop

参数名称 描述
visible 控制选择器显示和隐藏
column 可选值2和3,2是省市两列选择;3是省市区三列选择
maskCloseAble 点击模态框是否关闭弹框
defaultValue 初始地区编码(例:420102或者['河北省','唐山市','丰南区'])

数据来源:点击查看省市区数据来源

可接定制化组件开发

右侧有本人代表作小程序二维码,可以扫码体验

如使用过程中有问题或有一些好的建议,欢迎群互相学习交流:120594820

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问