# hk-city-picker 省市区选择组件

hk-city-picker组件依赖于el-casader级联组件。

# 默认用法

默认省市区单选,可选择任意等级,获取到的是最后一级的行政code

默认用法

code:

双向绑定

code: 110114

  hk-city-picker(v-model="code")

# 其他级别选择

可根据配置level变成省选择、省-市选择、省-市-区选择、省-市-区-街道选择。

省选择

code:

省-市选择

code:

省-市-区选择

code:

省-市-区-街道选择

code:

  hk-city-picker(v-model="provinceCode" level="province")
  hk-city-picker(v-model="cityCode" level="city")
  hk-city-picker(v-model="districtCode" level="district")
  hk-city-picker(v-model="streetCode" level="street")

# 获取完整code

默认用法

code: []

双向绑定

code: [ "130000", "130200", "130202" ]

  hk-city-picker(v-model="code" emitPath)

# 多选

多选

code:

完整code多选

code:

  hk-city-picker(v-model="code" multiple)
  hk-city-picker(v-model="code2" emitPath multiple)

# 可搜索

可搜索

code:

多选可搜索

code:

  hk-city-picker(v-model="code" filterable)
  hk-city-picker(v-model="code2" multiple filterable)

# API

参数 描述 类型 可选值 必须 默认值
value/v-model 选中项绑定值 String/Array true -
level 等级 String province/city/district/street - district
emitPath 在选中节点改变时,是否返回由该节点所在的各级菜单的值所组成的数组,若设置 false,则只返回该节点的值 Boolean - - false
props 配置选项 Object false json文件的value和label值
clearable 可清除 Boolean false true
multiple 多选 Boolean false false
placeholder 输入框占位文本 String false 请选择
size 尺寸 String medium/small/mini false
disabled 是否禁用 Boolean false false
show-all-levels 是否显示完整路径 Boolean false true
collapse-tags 多选模式是否折叠Tag Boolean false false
separator 选项分隔符 String '/'
filterable 是否可搜索选项 Boolean false
defaultValue 默认值,用于回显文案 String false

# Slots

名称 说明
- 自定义备选项的节点内容,参数为 { node, data },分别为当前节点的 Node 对象和数据
empty 无匹配选项时的内容

# Events

事件名称 说明 回调参数
change 当选中节点变化时触发 选中节点的值
expand-change 当展开节点发生变化时触发 各父级选项值组成的数组
blur 当失去焦点时触发 (event: Event)
focus 当获得焦点时触发 (event: Event)
visible-change 下拉框出现/隐藏时触发 出现则为 true,隐藏则为 false
remove-tag 在多选模式下,移除Tag时触发 移除的Tag对应的节点的值

tips: 更多配置项参考el-casader文档

最后更新: 7/19/2019, 8:49:51 PM