城市单选

北京市 北京市 北京市 北京市
北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市 北京市

*可以直接搜索查找城市(支持名称、拼音模糊搜索)清空5

最多只能选择5

市县级数据

whole: true

单选

multiSelect: false

简称

shorthand: true

开启搜索功能

search: true

设置城市默认

singleSelect1.setCityVal('北京市');

城市单选-只读

设置城市默认

singleSelect2.setCityVal('北京市');

只读

singleSelect2.showStatus('readonly');

城市单选-禁止

设置城市默认

singleSelect3.setCityVal('广州市');

禁止

singleSelect3.showStatus('disabled');

城市多选

市级数据

whole: false

开启多选功能

multiSelect: true

设置最多可选择的个数

multiMaximum: 6

关闭搜索功能

search: false

设置城市默认

MulticitySelect1.setCityVal('北京市, 天津市, 上海市, 广州市, 长沙市, 唐山市');

城市多选-自定义热门城市-搜索

市级数据

whole: false

开启多选功能

multiSelect: true

自定义热门城市

hotCity: ['北京市', '上海市', '广州市', '深圳市', '南京市', '杭州市', '天津市', '重庆市', '成都市', '青岛市', '苏州市', '无锡市', '常州市', '温州市', '武汉市', '长沙市', '石家庄市', '南昌市', '三亚市', '合肥市']

开启搜索功能

search: true

Options

名称 类型 默认 描述
dataJson [Array] 默认空 城市数据源
convert [Boolean] true(转换) 转换数据,引入的数据源是citydata.js就需要转换;引入的是newcitydata.js就不需要
whole [Boolean] false(市级) 显示市县级数据还是只显示市级数据,如果开启这个,需引入的数据源是citydata.js数据源才可以。
shorthand [Boolean] false(全称) 名称的全称、简称
multiSelect [Boolean] false(单选) 多选、单选
search [Boolean] true(搜索) 开启搜索
multiMaximum [Number] 5(最多可选5个城市) 最多可选的城市个数(多选)
multiType [Number] 0(多行) 值允许1或者0;只用于多选,选中的值显示是一行还是多行
placeholder [String] '请选择城市' 默认的提示语
searchPlaceholder [String] '输入关键词搜索' 搜索文本框默认的提示语
hotCity [Array] [](取前面18条数据) 热门城市显示数据,传就生成热门城市,没有就插件生成
onInit [function] function () {} 插件初始化后的回调
onForbid [function] function () {} 插件禁止后再点击的回调
onTabsAfter [function] function (target) {} 点击tabs切换显示城市后的回调
onTabsForbid [function] function (target) {} tabs禁止后再点击的回调
onCallerAfter [function] function (target, values) {} 选择城市后的回调

Methods

设置城市默认

setCityVal(val)

传入的参数是用字符串的形式:'北京市, 天津市, 上海市, 广州市, 长沙市, 唐山市'

注意: 如果设置的城市超过multiMaximum设置的限制的个数,多出的是不会生效

获取城市的值

getCityVal()

可以拿到选中的城市的值

注意: 只有在有选择城市的情况下,才能拿到城市的值或者是设置默认值后

更新城市数据

update(data)

栗子:singleSelect.update([{ "id": "110100", "name": "北京市", "parentId": "110000", "shortName": "北京", "letter": "B", "cityCode": "010", "pinyin": "Beijing" }, { "id": "120100", "name": "天津市", "parentId": "120000", "shortName": "天津", "letter": "T", "cityCode": "022", "pinyin": "Tianjin" }]);

城市状态

status(status)

参数是readonly或disabled

清空所有选中的值

clear()

绑定事件

bindEvent()

销毁事件

unBindEvent()