{extend name='extra@admin/content'} {block name="content"}
通过地区编码初始化设置
require(['citys'], function () { $('#demo').citys({code: 350206}); });
通过地区名称初始化设置,并且下拉框值为地区名称
require(['citys'], function () { $('#demo1').citys({valueType: 'name', province: '福建', city: '厦门', area: '思明'}); });
事件处理,并且下拉框值为地区名称
请选择地区
请选择地区
require(['citys'], function (ret) { $('#demo2').citys({ required: false, nodata: 'disabled', onChange: function (data) { var text = data['direct'] ? '(直辖市)' : ''; $('#place').text('当前选中地区:' + data['province'] + text + ' ' + data['city'] + ' ' + data['area']); } }); });
扩展显示行政区划第四级(街道)信息
require(['citys'], function () { var $town = $('#demo3 select[name="town"]'); var townFormat = function (info) { $town.hide().empty(); if (info['code'] % 1e4 && info['code'] < 7e5) { //是否为“区”且不是港澳台地区 $.ajax({ url: 'http://passer-by.com/data_location/town/' + info['code'] + '.json', dataType: 'json', success: function (town) { $town.show(); for (i in town) { $town.append(''); } } }); } }; $('#demo3').citys({ province: '福建', city: '厦门', area: '思明', onChange: function (info) { townFormat(info); } }, function (api) { var info = api.getInfo(); townFormat(info); }); });
调用方法:$(selector).citys(options,callback);
Options
参数 | 默认值 | 说明 |
---|---|---|
dataUrl | [数据库地址] |
数据库项目:中国行政区划(省、市、区、街道) |
dataType | 'json' |
数据库类型:'json'或'jsonp' IE9-由于默认安全设置,需开启“通过域访问数据源”才能跨域访问json,此类情况建议使用jsonp格式 |
crossDomain | true |
是否开启跨域 IE9-如果设置开启跨域而实际未跨域,造成请求异常 |
provinceField | 'province' | 省份(省级)字段名 |
cityField | 'city' | 城市(地级)字段名 |
areaField | 'area' | 地区(县区级)字段名 |
valueType | 'code' | 下拉框值的类型,code行政区划代码,name地名 |
code | 0 | 地区编码 |
province | [无] | 省份(省级),可以为地区编码或者名称 |
city | [无] | 城市(地级),可以为地区编码或者名称 |
area | [无] | 地区(县区级),可以为地区编码或者名称 |
required | true | 是否必须选中(是否自动选择地区) |
nodata | 'hidden' | 当无数据时的表现形式:'hidden'隐藏,'disabled'禁用,为空不做任何处理 |
onChange(info) | [无] | 地区切换时触发,回调函数传入地区信息:direct是否为直辖市,province省份(省级)名称,city城市(地级)名称,area地区(县区级)名称,code地区编码 |
callback(api)参数
方法 | 说明 |
---|---|
getInfo(data) | 获取当前选中的地区信息:direct是否为直辖市,province省份(省级)名称,city城市(地级)名称,area地区(县区级)名称,code地区编码 |