# Region 地区选择器
用于选择省市区的场景,选择更方便更高效;支持选择全省/全市,选择更加灵活通用
# 基本使用
<template>
<!-- 省份模式 -->
<com-region :value="region" mode="province" @confirm="handleConfirm"></com-region>
<!-- 城市模式 -->
<com-region :value="region" mode="city" @confirm="handleConfirm"></com-region>
<!-- 区模式 -->
<com-region :value="region" mode="area" @confirm="handleConfirm"></com-region>
<!-- 模糊选择 -->
<com-region :value="region" unclear @confirm="handleConfirm"></com-region>
</template>
<script>
export default {
data() {
return {
region: {
province: {
code: "",
name: "",
},
city: {
code: "",
name: "",
},
area: {
code: "",
name: "",
},
},
}
},
methods: {
handleConfirm(value, region){
this.region = region
console.log("地区", JSON.stringify(this.region))
},
}
}
</script>
# API
# Props
| 属性名 | 说明 | 类型 | 必填 | 默认值 |
|---|---|---|---|---|
| value | 地区默认值 | Object | false | - |
| mode | 地区模式 province、city、area | String | false | area |
| unclear | 是否为模糊选择(可选择省或市或区) | Boolean | false | false |
| placeholder | 默认占位文本 | String | false | 请选择 |
# Events
| 事件 | 说明 | 回调参数 |
|---|---|---|
| confirm | 点击确认后触发 | 第一个参数是省或者市或者区对象,第二个参数为完整的地区对象 |
| clear | 点击清空触发 | - |
| cancel | 点击遮罩关闭时触发 | - |
# Slots
| 名称 | 说明 | 默认内容 |
|---|---|---|
| default | 地区展示在页面的文本 | "-"分隔的省市区 |