20240517

uni_modules/sx-address-picker/readme.md

@@ -0,0 +1,45 @@
+# sx-address-picker
+ [中国省省市区 数据来源](https://github.com/modood/Administrative-divisions-of-China)
+
+ [国家地区来源](https://h5api.m.taobao.com/h5/mtop.cainiao.address.ua.global.area.list/1.0/?jsv=2.5.1&appKey=12574478&t=1712242102859&sign=0a30509ed7f24a5bf58a953d3d908dc2&api=mtop.cainiao.address.ua.global.area.list&v=1.0&dataType=jsonp&type=jsonp&callback=mtopjsonp2&data=%7B%22sn%22%3A%22suibianchuan%22%7D)
+
+# SxAddressPicker 地址选择器
+> **组件名：sx-address-picker**
+
+### 介绍
+
+该组件高仿淘宝地址省市区区域的picker交互效果，效果基本一致。
+
+
+
+### 安装方式
+
+本组件符合[easycom](https://uniapp.dcloud.io/collocation/pages?id=easycom)规范，`HBuilderX 2.5.5`起，只需将本组件导入项目，在页面`template`中即可直接使用，无需在页面中`import`和注册`components`。
+
+### 基本用法 
+
+更多示例请下载示例安装查看。该组件依赖官方ui组件uni-icons、uni-list、uni-load-more、uni-popup、uni-transition，如果项目本身已导入uni-ui，请忽略。
+两个json文件在示例包static文件下，自己引入或自建cdn
+
+```html
+<sx-address-picker v-model="addressPopup" @confirm="addressConfirm"/>
+```
+
+## API
+
+### Props
+
+| 属性名    | 类型           | 默认值 | 说明                            |
+| --------- | -------------- | ------ | ------------------------------- |
+| value | Boolean | false | 控制picker是否显示，可使用v-model进行控制。 |
+| selected | Array          | []     | 可选，默认回显的选项。 |
+
+### Events
+
+| 事件称名 | 说明                 | 返回参数                                         |
+| -------- | -------------------- | ------------------------------------------------ |
+| confirm  | 当点击完成选择时发出 | 用户选择完毕/收起菜单，触发confirm事件，event=[] |
+
+### 名人语录
+
+每个人都会有缺陷，就像被上帝咬过的苹果，有的人缺陷比较大，正是因为上帝特别喜欢他的芬芳。——**托尔斯泰（俄国）**