JS省市区使用文档
一：服务器返回JSON格式要求如下网址里面data的格式：(拿KISSY组件data格式来做的)
http://gallery.kissyui.com/cityselector/doc/linkage-data.js
二：使用时，页面head部分需要引入jquery和省市区JS，依赖于HTML结构如下：
<select id="prov4" data-code="220000"></select>
<select id="city4" data-code="220300"></select>
<select id="area4" data-code="220322"></select>
属性说明：
id：下拉框dom节点(页面上是唯一的)，用于js初始化的钩子。
data-code: 初始化页面时可以根据省市区的编码来指定那个省份，市及区来显示。比如我想指定 "吉林省 长春市 朝阳区" 页面默认显示的话，我们可以在HTML结构上加相对应的data-code编码来指定，比如如下：
<select class="prov" id="prov4" data-code ="220000"></select>
<select class="city" id="city4" data-code ="220100"></select>
<select class="dist" id="area4" data-code ="220104"></select>
页面一打开的时候如下显示：
三：省市区JS初始化的方法如下：
var selectVal = new CitySelect({
data : data,
provId : "#prov4",
cityId : '#city4',
areaId : '#area4'
});
属性说明如下：
data: data配置项是指 后台返回的json数据的保存的全局变量。
provId 指省份下拉框select的id。
cityId 指城市下拉框select的id。
areaId 指区下拉框select的id。
省市区id传参方式：都是以 #XXX的.
省市区基本的配置项如下：
data: 指后台返回的JSON数据。
provId： 省份下拉框select的id。
cityId： 指城市下拉框select的id。
areaId: 指区下拉框select的id。
isSelect: 默认为true 选择第一项 如果页面有指定省市区项时，就显示指定项。如果false，就选中 "请选择"
provCallBack: 省份下拉框渲染完成后的回调函数。
cityCallBack： 市下拉框渲染完成后的回调函数。
areaCallBack： 区下拉框渲染完成后的回调函数。
demo演示：
一：默认的HTML结构如下：
<select class="prov" id="prov4"></select>
<select class="city" id="city4"></select>
<select class="dist" id="area4"></select>
JS代码初始化的方式如下：
var selectVal = new CitySelect({
data : data,
provId : "#prov4",
cityId : '#city4',
areaId : '#area4'
});
打开页面后，页面显示如下：
1. 可以看到，页面一打开的时候 默认显示第一项 北京，我们也可以根据 省 市 区 切换其他省份去，可以看到上面的gif图时，下面的select中的属性data-code也跟着变化，如果省份切换到请选择下拉框时候，那么省 市 区中的data-code变为-1，且市，区不可选择，只能是 请选择下拉框。
2. 当有省份时候，我切换市 到 "请选择"项时候 那么区也变为请选择 相应的 市和区 select中的data-code 值变为-1。其中data-code 就是form表单提交时候 需要的。也就是说 某某省份下的所有市和所有区。
3. 当同时有省，市的时候，我区也可以change，那么当选择其他的区的时候 data-code也同时变化，当切换到请选择的时候 那么value为-1，也就是说是 某某省 某某市下面的所有区。
二： 第二种就是假如页面一初始化的时候我想指定某某省 某某市 某某区的时候，要如何编写HTML结构呢，比如像下面的图上一样。
我们可以在select框加上data-code属性来指定，如下：
注意：如果我指定了省份是：浙江省，市：不是浙江省里面的市，那么选中的市是浙江省的默认的第一个市，同理 区也一样。
三： 第三种初始化是：通过配置项 isSelect 来配置的，默认此配置项为true，如果没有指定省市区的话，那么默认选种第一项，如果有指定省市区的话，那么显示指定的省市区。如果 isSelect 配置项为false的话，那么默认显示是 请选择下拉框。可以看下代码如下判断！
我们也可以看看gif图显示的。
如上gif图所示：默认显示都是 "请选择"下拉框，data-code都为-1，当选择 某某省时候 data-code值变化，但是相对应的 "市" 和 "区" 还是请选择下拉框，同理当选中某项市的时候，select中的属性data-code也相应的变化，但是区下拉框还是"请选择"下拉框。当选择区某项的时候 data-code也相应的变化。
JS初始化方式如下，只需要增加一个配置项 isSelect:false即可，如下：
var selectVa2 = new CitySelect({
data : data,
provId : "#prov5",
cityId : '#city5',
areaId : '#area5',
isSelect: false
});
下面是所有的HTML代码如下
<!doctype html>View Code
<html lang="en">
<head>
<meta charset="UTF-8">
<script type="text/javascript" src="js/jquery-1.4.4.min.js"></script>
<script src="js/city2.js"></script>
<script type="text/javascript" src="js/citySelect2.js"></script>
<title>Document</title>
</head>
<body>
<div id="city_4">
<select class="prov" id="prov4" data-code ="220000"></select>
<select class="city" id="city4" data-code ="220100"></select>
<select class="dist" id="area4" data-code ="220104"></select>
</div>
<div id="city_5">
<select class="prov" id="prov5">
</select>
<select class="city" id="city5"></select>
<select class="dist" id="area5"></select>
</div>
<script>
var selectVal = new CitySelect({
data : data,
provId : "#prov4",
cityId : '#city4',
areaId : '#area4'
});
var selectVa2 = new CitySelect({
data : data,
provId : "#prov5",
cityId : '#city5',
areaId : '#area5',
isSelect: false
});
</script>
</body>
</html>
javascript代码如下：
/**View Code
* Jquery省市区联动代码重构
* @version 0.0.2
*/
function CitySelect(options) {
this.config = {
data : '', // 数据
provId : '', // 省下拉框id容器 格式是 #XXX
cityId : '', // 市下拉框id容器 格式是 #XXX
areaId : '', // 区下拉框id容器 格式是 #XXX
isSelect : true, // 默认为true 选择第一项 如果页面有指定省市区项时，就显示指定项。
// 如果false，就选中 "请选择"
provCallBack : null, // 省份渲染完成后回调
cityCallBack : null, // 市渲染完成后的回调
areaCallBack : null // 区渲染完成后的回调
};
this.config = $.extend(this.config, options || {});
this.init();
}
CitySelect.prototype = {
constructor: CitySelect,
/*
* 初始化方法init
*/
init: function() {
var self = this,
_config = self.config;
if(!/^#/.test(_config.provId)) {
alert("省份ID传的不正确,格式是 #XXX");
return;
}
if(!/^#/.test(_config.cityId)) {
alert("城市ID传的不正确,格式是 #XXX");
return;
}
if(!/^#/.test(_config.cityId)) {
alert("区ID传的不正确,格式是 #XXX");
return;
}
this.provCode = $(_config.provId).attr("data-code");
this.cityCode = $(_config.cityId).attr("data-code");
this.areaCode = $(_config.areaId).attr("data-code");
// 使省市区id (#XX --> XX)
this.provid = _config.provId.replace(/^#/g,'');
this.cityid = _config.cityId.replace(/^#/g,'');
this.areaid = _config.areaId.replace(/^#/g,'');
// 渲染省份
self._provFunc();
//渲染省对应的市
self._cityFunc();
// 渲染省市 对应的区
self._areaFunc();
// 如果省份的值是-1的话 那么设置省市区select都为-1
var provFirstOpt = $(_config.provId).val();
if(provFirstOpt == -1) {
$(_config.provId).attr("data-code","-1");
$(_config.cityId).attr("data-code","-1");
$(_config.areaId).attr("data-code","-1");
}
// change事件 省切换 自动切换市 and 区
$(_config.provId).change(function(e){
self._cityFunc();
self._areaFunc();
});
// 市 change事件 自动切换区
$(_config.cityId).change(function(e){
self._areaFunc();
});
// 区change事件
$(_config.areaId).change(function(){
$(_config.areaId).attr("data-code",$(this).val());
});
},
/*
* 渲染省数据
* @method _provFunc {private}
*/
_provFunc: function(){
var self = this,
_config = self.config;
var elemHtml = '';
elemHtml+= '<option value="-1" data-name="请选择" selected>请选择</option>';
$(_config.data).each(function(i,curItem){
elemHtml += "<option data-name='"+curItem[1]+"' value='"+curItem[0]+"'>"+curItem[1]+"</option>";
});
$(_config.provId).html(elemHtml);
if(_config.isSelect) {
$($(_config.provId + " option")[1]).attr("selected",'true');
if(this.provCode) {
self._setSelectCode(_config.provId,this.provCode);
}
}
_config.provCallBack && $.isFunction(_config.provCallBack) && _config.provCallBack();
},
/*
* 渲染省对应的市数据
* @method _cityFunc {private}
*/
_cityFunc: function(){
var self = this,
_config = self.config;
var provIndex = $(_config.provId).get(0).selectedIndex, // 获取省份的索引index
elemHtml = '',
prov,
citys,
provOpt;
provOpt = $($(_config.provId + ' option')[0]).attr("value");
var opthtml = '<option value="-1" data-name="请选择" selected>请选择</option>';
// 如果省有请选择的话 那么相应的省要减一
if(provOpt == -1) {
provIndex--;
}
$(_config.cityId).empty();
$(_config.areaId).empty();
/*
* 如果选择的是 第一项 "请选择" 的话 那么省市区的value都为-1
* 并且默认选中市 区的第一项 请选择option
*/
if(provIndex < 0){
$(_config.provId).attr("data-code",'-1');
$(_config.cityId).attr("data-code",'-1');
$(_config.areaId).attr("data-code",'-1');
$(_config.cityId).html(opthtml);
$(_config.areaId).html(opthtml);
return;
}
prov = _config.data[provIndex];
citys = prov[2];
elemHtml += '<option value="-1" data-name="请选择">请选择</option>';
for(var m = 0; m < citys.length; m++) {
var oneCity = citys[m];
elemHtml += "<option value='"+oneCity[0]+"' data-name='"+oneCity[1]+"'>"+oneCity[1]+"</option>";
}
$(_config.cityId).html(elemHtml);
if(_config.isSelect) {
$($(_config.cityId + " option")[1]).attr("selected",'true');
if(this.cityCode) {
self._setSelectCode(_config.cityId,this.cityCode);
}
}
self._selectChangeCode();
_config.cityCallBack && $.isFunction(_config.cityCallBack) && _config.cityCallBack();
},
/*
* 渲染市对应的区数据
* @method _areaFunc {private}
*/
_areaFunc: function(){
var self = this,
_config = self.config;
var provOpt = $($(_config.provId + ' option')[0]).attr("value"),
cityOpt = $($(_config.cityId + ' option')[0]).attr("value");
var provIndex = $(_config.provId).get(0).selectedIndex,
cityIndex = $(_config.cityId).get(0).selectedIndex,
elemHtml = "",
prov,
citys,
areas,
oneCity;
var opthtml = '<option value="-1" data-name="请选择" selected>请选择</option>';
/*
* 如果省选择了 "请选择了" 那么省和市自动切换到请选择 那么相应的索引index-1
* 如果省没有选择 "请选择"，市选择了 "请选择" 那么市的索引index - 1
*/
if(provOpt == -1) {
provIndex--;
cityIndex--;
}else if(provOpt != -1 && cityOpt == -1) {
cityIndex--;
}
if(provIndex < 0 || cityIndex < 0){
$(_config.cityId).attr("data-code",'-1');
$(_config.areaId).attr("data-code",'-1');
$(_config.areaId).html(opthtml);
return;
};
prov = _config.data[provIndex];
citys = prov[2];
oneCity = citys[cityIndex];
areas = oneCity[2];
elemHtml += '<option value="-1" data-name="请选择">请选择</option>';
if(areas != null) {
for(var n = 0; n < areas.length; n++) {
var oneArea = areas[n];
elemHtml += "<option value='"+oneArea[0]+"' data-name='"+oneArea[1]+"'>"+oneArea[1]+"</option>";
}
}
$(_config.areaId).html(elemHtml);
if(_config.isSelect) {
$($(_config.areaId + " option")[1]).attr("selected",'true');
if(this.areaCode) {
self._setSelectCode(_config.areaId,this.areaCode);
}
}
self._selectChangeCode();
_config.areaCallBack && $.isFunction(_config.areaCallBack) && _config.areaCallBack();
},
/*
* 根据change事件来改变省市区select下拉框的data-code的值
* @method _changeSetCode private
* @param selectId 省市区select dom节点
*/
_changeSetCode: function(selectId){
var self = this,
_config = self.config;
var idx = selectId.selectedIndex, //获取选中的option的索引
option,
value,
dataValue = $(_config.provId).val();
var html = "<option data-name='请选择' value='-1' selected>请选择</option>",
provOpt = $($(_config.provId + ' option')[0]).attr("value");
if(idx > -1) {
if(dataValue == -1) {
if(provOpt != "-1") {
$(_config.provId).prepend(html);
$(_config.cityId).prepend(html);
$(_config.areaId).prepend(html);
}
$(_config.provId).attr("data-code",'');
$(_config.cityId).attr("data-code",'');
$(_config.areaId).attr("data-code",'');
}else {
option = selectId.options[idx]; //获取选中的option元素
value = $(option).val();
$(selectId).attr("data-code",value);
}
}
},
_selectChangeCode: function(){
var self = this,
_config = self.config;
// 省change事件时候 省select下拉框data-code也要变化
var provId = document.getElementById(this.provid);
self._changeSetCode(provId);
// 市change事件时候 市select下拉框data-code也要变化
var cityId = document.getElementById(this.cityid);
self._changeSetCode(cityId);
// 区change事件时候 市select下拉框data-code也要变化
var areaId = document.getElementById(this.areaid);
self._changeSetCode(areaId);
},
/*
* 根据下拉框select属性data-code值 来初始化省下拉框的值
* @method _setSelectCode {private}
* @param selectId 下拉框的Id
*/
_setSelectCode: function(selectId,code){
var self = this,
_config = self.config;
var optionElems = $(selectId + " option");
$(optionElems).each(function(index,item){
var curCode = $(item).val();
if(curCode == code) {
$(item).attr("selected",'true');
$(selectId).attr("data-code",curCode);
return;
}
});
}
};