基于 Vue city-picker 组件

2,196 阅读3分钟
原文链接: lquan529.github.io

Citypicker

一级城市

  • 北京市
  • 天津市
  • 河北省
  • 山西省
  • 内蒙古自治区
  • 辽宁省
  • 吉林省
  • 黑龙江省
  • 上海市
  • 江苏省
  • 浙江省
  • 安徽省
  • 福建省
  • 江西省
  • 山东省
  • 河南省
  • 湖北省
  • 湖南省
  • 广东省
  • 广西壮族自治区
  • 海南省
  • 重庆市
  • 四川省
  • 贵州省
  • 云南省
  • 西藏自治区
  • 陕西省
  • 甘肃省
  • 青海省
  • 宁夏回族自治区
  • 新疆维吾尔自治区
  • 台湾省
  • 香港特别行政区
  • 澳门特别行政区

设置:level属性来定义城市的级数

调用@choice-caller回调,作用是选择选项后触发的事件

二级城市

  • 北京市
  • 天津市
  • 河北省
  • 山西省
  • 内蒙古自治区
  • 辽宁省
  • 吉林省
  • 黑龙江省
  • 上海市
  • 江苏省
  • 浙江省
  • 安徽省
  • 福建省
  • 江西省
  • 山东省
  • 河南省
  • 湖北省
  • 湖南省
  • 广东省
  • 广西壮族自治区
  • 海南省
  • 重庆市
  • 四川省
  • 贵州省
  • 云南省
  • 西藏自治区
  • 陕西省
  • 甘肃省
  • 青海省
  • 宁夏回族自治区
  • 新疆维吾尔自治区
  • 台湾省
  • 香港特别行政区
  • 澳门特别行政区
  • 北京市

设置:default-city属性来定义默认城市

设置:level属性来定义城市的级数

三级城市

  • 北京市
  • 天津市
  • 河北省
  • 山西省
  • 内蒙古自治区
  • 辽宁省
  • 吉林省
  • 黑龙江省
  • 上海市
  • 江苏省
  • 浙江省
  • 安徽省
  • 福建省
  • 江西省
  • 山东省
  • 河南省
  • 湖北省
  • 湖南省
  • 广东省
  • 广西壮族自治区
  • 海南省
  • 重庆市
  • 四川省
  • 贵州省
  • 云南省
  • 西藏自治区
  • 陕西省
  • 甘肃省
  • 青海省
  • 宁夏回族自治区
  • 新疆维吾尔自治区
  • 台湾省
  • 香港特别行政区
  • 澳门特别行政区
  • 北京市
  • 东城区
  • 西城区
  • 朝阳区
  • 丰台区
  • 石景山区
  • 海淀区
  • 门头沟区
  • 房山区
  • 通州区
  • 顺义区
  • 昌平区
  • 大兴区
  • 怀柔区
  • 平谷区
  • 密云县
  • 延庆县

注意:如果没有设置:level属性,默认是三级城市

设置:default-city属性来定义默认城市

调用@visible-change回调,作用是显示/隐藏下拉框触发的事件

禁止选择城市

  • 北京
  • 天津
  • 河北
  • 山西
  • 内蒙古
  • 辽宁
  • 吉林
  • 黑龙江
  • 上海
  • 江苏
  • 浙江
  • 安徽
  • 福建
  • 江西
  • 山东
  • 河南
  • 湖北
  • 湖南
  • 广东
  • 广西
  • 海南
  • 重庆
  • 四川
  • 贵州
  • 云南
  • 西藏
  • 陕西
  • 甘肃
  • 青海
  • 宁夏
  • 新疆
  • 台湾
  • 香港
  • 澳门
  • 北京
  • 东城
  • 西城
  • 朝阳
  • 丰台
  • 石景山
  • 海淀
  • 门头沟
  • 房山
  • 通州
  • 顺义
  • 昌平
  • 大兴
  • 怀柔
  • 平谷
  • 密云
  • 延庆

设置:default-city属性来定义默认城市

设置:short-name属性来显示城市名称、全称/简写

设置:disabled属性禁止城市选择

Citypicker Attributes

参数 说明 类型 默认值
city-data 城市数据源 Array -
default-city 默认城市设置 String -
selectpattern 配置城市字段名及默认提示文字 Array [{field: 'userProvinceId', placeholder: '请选择省份'}, {field: 'userCityId', placeholder: '请选择城市'}, {field: 'userDistrictId', placeholder: '请选择区县'}]
short-name 显示城市名称。简写/全称 Boolean false
storage 存储选中值的类型,Name/Id Boolean true
level 显示城市的级数 Number 3
disabled 禁用 Boolean false

Citypicker Events

事件名称 说明 回调参数
choice-caller 选择选项触发的事件回调 values:[name, id]
visible-change 城市下拉框出现/隐藏时触发 visible:出现则为 false,隐藏则为 true