# 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:toggle 或 event: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() |