# AreaSelect 地址

# 迁移

提示

由于将地区数据源迁移到 cdn 上,因此新增了一个prop:source,是一个返参为Promise(Promise需要返回Array数据)Array类型的函数,内部通过该 prop 获取数据源;

为了压缩数据源大小,因此将adcode修改为id,同时删除无用的键值citycode。为了向下兼容,因此adcode将作为id别名,同时在输出值后仍保留输出adcode

新的功能模块请使用id

# 引入

import { H3AreaSelect } from '@lateinos/awesome-ui';

export default {
  components: {
    H3AreaSelect,
  },
};

# 地址控件

# 省市县

# 省市

省市的格式配置由于香港特别行政区与台湾省没有“市级”数据,所以做了特殊处理。

#

# 提前确定

# API

# prop

参数 说明 类型 必填 可选值 默认值
value 默认值 array demo:[ { "id": "440000", "name": "广东省", "level": "province" }, { "id": "440300", "name": "深圳市", "level": "city" }, { "id": "440305", "name": "南山区", "level": "district" } ], id别名为adcode []
format 区域类型 string P-C-T,P-C,P P-C-T
placeholder 提示文本 string '请选择省市区'
disabled 是否禁用 boolean false
visible 手动控制是否隐藏及显示,请与event:toggleevent:show event:hide 联动使用 boolean false
isScoped 是否可以提前确定 boolean false
source 区域数据,一个返参为Promise(Promise 需要返回 Array 数据)或Array类型的函数 或 数组 function|array () => []
control 是否禁用自动隐藏,若设置true点击弹窗外面不会自动隐藏,请通过visible控制 boolean false
controlCls 若弹窗中会出现弹窗,而不想点击次级弹窗时关闭弹窗则可以添加该prop,来控制有该class的元素及其子元素点击不会关闭 string | string[] -
overlayCls 自定义下拉框类名 string -
offset reference 的[偏移, 间距] Array | Function => [] -
zIndex 自定义 z-index string | number -
autoHide 当触发区域不在可视区域时, 弹窗是否自动隐藏 boolean true
appendToBody 是否将弹窗移动到body上,优先级低于getParentContainer boolean true
getParentContainer 将弹窗移动到某个指定DOM元素上,优先级高于appendToBody函数必须返回一个DOM元素 Function -
getBoundaryContainer 将弹窗限制在某个指定DOM元素范围内显示,函数必须返回一个DOM元素 Function -

# event

参数 说明 参数
input v-model 绑定事件 selectedData:[ { "id": "440000", "name": "广东省", "center": "113.280637,23.125178", "level": "province", "adcode": "440000" }, { "id": "440300", "name": "深圳市", "center": "114.085947,22.547", "level": "city", "adcode": "440300" }, { "id": "440305", "name": "南山区", "center": "113.92943,22.531221", "level": "district", "adcode": "440305" } ]
change 回调函数 selectedData[ { "id": "440000", "name": "广东省", "center": "113.280637,23.125178", "level": "province", "adcode": "440000" }, { "id": "440300", "name": "深圳市", "center": "114.085947,22.547", "level": "city", "adcode": "440300" }, { "id": "440305", "name": "南山区", "center": "113.92943,22.531221", "level": "district", "adcode": "440305" } ]
toggle 下拉框显示隐藏切换时触发 Function(visible)
show 下拉框显示时触发 Function()
hide 下拉框隐藏时触发 Function()