
EasyUI 的 combobox 很適合用來製作省市區三級聯動。核心概念是:當省份改變時,重新載入城市資料;當城市改變時,再重新載入區縣資料。
先建立 province、city、county 三個 combobox 欄位,再呼叫自訂的 citySelect 方法進行初始化。若需要回填表單,可使用 form 的 load 方法。
$(function () {
$.citySelect({
$province: $('#province'),
$city: $('#city'),
$County: $('#county')
});
$('#ff').form('load', {
'province': '廣東省',
'city': '深圳市',
'county': '羅湖區'
});
});
有時需要依索引設定或取得 combobox 的值。可透過 jQuery 擴充 combobox 的 methods,加入 setIndex 與 getIndex。
$.extend($.fn.combobox.methods, {
setIndex: function (jq, index) {
var data = $(jq).combobox('options').data;
var valueField = $(jq).combobox('options').valueField;
if (data[index]) {
$(jq).combobox('setValue', data[index][valueField]);
}
},
getIndex: function (jq) {
var index = 0;
var data = $(jq).combobox('options').data;
var valueField = $(jq).combobox('options').valueField;
var value = $(jq).combobox('getValue');
data.forEach(function (item, i) {
if (item[valueField] === value) {
index = i;
}
});
return index;
}
});
citySelect 通常會維護省份、城市與區縣的對應資料。初始化時先載入省份;當省份改變,就從對應資料中取出城市清單,並設定 combobox 的 data。城市改變時,再取出該城市的區縣清單。
$province.combobox({
editable: false,
valueField: 'text',
textField: 'text',
data: provinceData,
onChange: function (newValue) {
if (newValue !== '') {
var cityData = getCityData(newValue);
$city.combobox({
editable: false,
data: cityData,
valueField: 'text',
textField: 'text',
onChange: function (cityValue) {
if (cityValue !== '') {
$County.combobox({
editable: false,
data: getCountyData(cityValue),
valueField: 'text',
textField: 'text'
});
}
}
});
}
}
});
實際專案可將龐大的行政區資料整理成 JSON 或物件映射,避免把大量資料直接寫在前端腳本中,方便維護與擴充。