省市区三级联动选择, 在我们开发中很常见, 下一级的下拉框数据与上一级的下拉框的值紧密相关, 所以需要我们处理的时候格外小心, 及时清理数据, 异步加载数据时再去绑定值不容半点马虎.
我今天给大家分享一个比较通用的Js插件, 虽然叫JQuery插件, 但也只是引用到了它一般的方法, 并非底层. 这个插件除了省市区外, 还可以根据自己的意思灵活配置成你想要的三级联动或二级联动.
插件的下载地址: http://download.csdn.net/download/freshflower/8748521 (赚点小积分, 嘿嘿)
引入Jquery, 再引入插件. 然后我来讲解一下使用方法
// 初始化实例
var obj = $.cascade({
container: { first: '#firstid', second: '#secondid', third: '#thirdid' },
method: 'post',
cache: true,
local: false, //是否取本地数据: true:则需设置dataJson; false:则需设置dataUrl取服务器上的数据. (推荐取服务器的数据)
dataUrl: { first: '/url/province', second: '/url/city?province=', third: '/url/area?city=' }, //这里的URL地址根据你的实际情况设定
field: {
first: { text: 'areaname', value: 'areacode' },
second: { text: 'areaname', value: 'areacode' },
third: { text: 'areaname', value: 'areacode' }
},
options: {
first: { text: 'Please Choose', value: '' },
second: { text: '所有城市', value: '-' }, //在下拉控件上显示"所有城市"的项, 其值为"-"
third: { text: '', value: '' } //为空表示只显示数据项
},
startText: ['浙江省', '杭州市', '西湖区'], //起始加载省市区的
startValue: ['10', '100571', '10057103'] //起始加载的值(与startText二选一, 优先使用startValue)
});
// 方法调用 可调用的方法就只有这两个, 其他方法为函数内部方法.
// 这两个方法主要优点在于一次性设定, 无需考虑异步的情况, 他会自动去处理异步加载.
// 1. 设置选中值:
obj.setValues(['10', '100571', '10057103']); //依照数组的值依次设定 一级下拉框,二级下拉框, 三级下拉框的值
// 2. 设置选中文本:
obj.setTexts(['浙江省', '杭州市']); //依照数组的值依次设定 一级下拉框,二级下拉框的选中文本, (三级下拉框不设定,默认第一个选项)
重点讲根据URL来获取服务器数据, 除一级下拉框对应的数据URL不额外加参数外,另外两个都会根据上一下拉框所选中的值来请求数据, 例如: 省份选择了浙江省, 那么就要拉取浙江省下的所有城市, 这时, dataUrl.second就会将省份中选中的值当成参数向服务器请求数据. (如上下的数据就会得到"/url/city?province=10"这个地址, 同理城市选择了杭州市, 就会得到第三级数据的请求地址: "/url/area?city=100571")
服务器返回数据格式如下, 必须是JSON数组
//获取到所有的省份
//json中的areacode,与areaname字段名称可根据自身的需要写,只要相关配置到初始化时的参数中的field中即可.
[
{"areacode": 10, "areaname": "浙江省"},
{"areacode": 11, "areaname": "北京市"},
{"areacode": 12, "areaname": "天津市"},
{"areacode": 13, "areaname": "河北省"},
{"areacode": 14, "areaname": "山西省"},
{"areacode": 15, "areaname": "内蒙古自治区"} //,{...}省略很多
]
//------我---是---分---隔----线-------------
//获取到浙江省下面的市的数据, (获取某个城市下的行政区就不用再枚举了,结构是一样的)
[
{"areacode": 100570, "areaname": "衢州市"},
{"areacode": 100571, "areaname": "杭州市"},
{"areacode": 100572, "areaname": "湖州市"},
{"areacode": 100573, "areaname": "嘉兴市"},
{"areacode": 100574, "areaname": "宁波市"},
{"areacode": 100575, "areaname": "绍兴市"},
{"areacode": 100576, "areaname": "台州市"},
{"areacode": 100577, "areaname": "温州市"},
{"areacode": 100578, "areaname": "丽水市"},
{"areacode": 100579, "areaname": "金华市"},
{"areacode": 100580, "areaname": "舟山市"}
]
如果你想取本地的数据, 那么在函数初始化时, 必须初始化其本地数据dataJson, 格式如下:
dataJson ={"first": [ /* first必须是数组,所有省份列表 */
{"areacode": 10, "areaname": "浙江省"},
{"areacode": 11, "areaname": "北京市"},
{"areacode": 12, "areaname": "天津市"},
{"areacode": 13, "areaname": "河北省"},
{"areacode": 14, "areaname": "山西省"},
{"areacode": 15, "areaname": "内蒙古自治区"} //,{...}省略很多
],
"second": { /* 枚举所有的城市 */
"10":[{"areacode": 100570, "areaname": "衢州市"},{"areacode": 100571, "areaname": "杭州市"}/*,省略很多, 这里的10指first中areacode=10的项,以其值作为key,那么value就是城市列表的数组 */ ],
"11": [{"areacode":11010,"areaname":"北京市"}]
},
"third": { /* 枚举出所有城市下所有的地区 */
"100571":[{"areacode": 10057101, "areaname": "上城区"}, {"areacode": 10057102, "areaname": "下城区"}, {"areacode": 10057103, "areaname": "西湖区"}]
/* "100572":[{...},{...}], 省略很多很多.... */
} //综合起来,数据量太大了, 不是好事, 所以不推荐使用.