上传代码

distribution/uni_modules/mo-city-group/readme.md

@@ -0,0 +1,84 @@
+## city 地址联动
+> **组件名：mo-city-group**
+> 代码块： `mo-city-group`
+
+省市县区街道地区四级联动
+理论上支持所有平台，可自行尝试
+
+### [使用文档]
+### 
+```javascript
+
+属性：
+
+|diyStyle							|{}	                    |外层自定义样式													|
+|province							|String	 		        |默认省份全称													|
+|city							    |String	 		        |默认城市全称													|
+|area							    |String	 		        |默认县区全称													|
+|street							    |String	 		        |默认街道全称													|
+|keyName							|String	= [name]        |要显示的对象字段名											    |
+|isProvince				            |Boolean|true			|是否显示省份										|
+|isCity				                |Boolean|true			|是否显示城市										|
+|isArea				                |Boolean|true			|是否显示县区										|
+|isStreet				            |Boolean|true			|是否显示街道										|
+|isShowTip				            |Boolean|true			|是否显示选择省市县街道的选项										|
+|provinceTitle				        |String	= [全部省份]		|不选择省份时的文字，或显示选择省市县街道选项的提示文字（isShowTip=true时有效）
+|cityTitle				            |String	= [全部城市]		|不选择城市时的文字，或显示选择省市县街道选项的提示文字（isShowTip=true时有效）
+|areaTitle				            |String	= [全部县区]		|不选择县区时的文字，或显示选择省市县街道选项的提示文字（isShowTip=true时有效）
+|streetTitle				        |String	= [全部街道]		|不选择街道时的文字，或显示选择省市县街道选项的提示文字（isShowTip=true时有效）|
+
+事件：
+|provinceChange				        |Event|{code:0,name:'名称'}			|省份选择事件										|
+|cityChange				            |Event|{code:0,name:'名称'}			|城市选择事件										|
+|areaChange				            |Event|{code:0,name:'名称'}			|县区选择事件										|
+|streetChange				        |Event|{code:0,name:'名称'}			|街道选择事件										|
+
+```
+### [使用示例]
+
+
+```javascript
+
+###注意事项
+由于四级联动JS数据文件过大，小程序须在分包使用加载本组件，否则无法上传体验版。主包使用时，建议跳转到分包页面加载选择地址后，再返回给主包调用。
+
+分包策略如下：
+1、把uni_modules\mo-city-group目录下的components目录整体移到你的分包目录（多个分包要遵循ABCD...能依次访问并加载的策略，或将本自定义组件放于每个分包中）;
+2、pages.json文件中配置自动加载，如本组件的分包路径是pagesA/components/...
+   则pages.json配置：
+	"easycom": {
+		"autoscan": true,
+		"custom": {
+			"^mo-(.*)": "@/pagesA/components/mo-$1/mo-$1.vue"  //此为本组件的自动加载路径
+		}
+	}
+3、这时只需在分包模板文件中使用组件，无需导入组件，可自动加载分包中的本组件。
+
+    <template>
+    <view>
+	<mo-city-group class="color-whites any-font-size-12"  dataUrl="http://127.0.0.1/comjs/city.js" 
+						:isProvince="true" :isCity="true" province="浙江省" city="台州市" 
+						@area-change="citygroupChangeSo($event,'area')" 
+						@street-change="citygroupChangeSo($event,'street')"
+						@province-change="citygroupChangeSo($event,'province')"
+						@city-change="citygroupChangeSo($event,'city')"></mo-city-group>
+	</view>
+	</template>
+	<script>
+	export default{
+		methods:{
+			citygroupChangeSo(event,type){
+				console.log(event,type)
+			}
+		}
+	}
+	</script>
+	
+4、分包配置完后，记得删除uni_modules目录下的mo-city-group目录，避免小程序无法上传体验版本。
+
+```
+
+
+#### 如使用过程中有任何问题，或者您对此组件有一些好的建议，欢迎联系微信：actioniing 
+
+