106 lines
3.2 KiB
Markdown
106 lines
3.2 KiB
Markdown
## 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或者['河北省','唐山市','丰南区']） |
|
||
|
||
### 数据来源：[点击查看省市区数据来源](https://github.com/modood/Administrative-divisions-of-China/blob/master/dist/pca-code.json)
|
||
### 可接定制化组件开发
|
||
### 右侧有本人代表作小程序二维码，可以扫码体验
|
||
### 如使用过程中有问题或有一些好的建议，欢迎加QQ群互相学习交流：120594820 |