地址表單幾乎每個專案都會遇到:選了省要自動列出對應的市,選了市再列出區。以下整理兩種常見做法,一種是套用現成 jQuery 插件,一種是用原生 JavaScript 自己實作,並說明如何設定預設值。
三個 select 各帶一個 class 與 data-code 屬性,用來回顯後端傳來的值:
<select class="prov" id="prov5" name="Province" data-code="@Model.Province"></select> <select class="city" id="city5" name="City" data-code="@Model.City"></select> <select class="dist" id="area5" name="Area" data-code="@Model.Area"></select> @Html.HiddenFor(m => m.Province) @Html.HiddenFor(m => m.City) @Html.HiddenFor(m => m.Area)
<script type="text/javascript">
var selectVa2 = new CitySelect({
data: data,
provId: "#prov5",
cityId: '#city5',
areaId: '#area5',
isSelect: true
});
</script>
<script src="@Url.Content("~/Themes/Admin/JS/jquery-1.4.4.min.js")" type="text/javascript"></script>
<script src="@Url.Content("/Themes/Admin/JS/city2.js")" type="text/javascript"></script>
<script src="@Url.Content("/Themes/Admin/JS/citySelect2.js")" type="text/javascript"></script>
其中 city2.js 負責存放行政區資料,citySelect2.js 負責聯動邏輯,jQuery 則是前置依賴。這種做法的優點是接入快,缺點是多了一次外部檔案與 jQuery 的載入成本。
HTML 結構很單純,三個空的 select 加上一個外掛腳本:
<html>
<body>
<label for="select_city">城市</label>
<div data-role="controlgroup" id="select_p_c_a" data-ajax="false">
<select id="select_province"></select>
<select id="select_city"></select>
<select id="select_area"></select>
</div>
<script src="test.js"></script>
<script>
region_init("select_province", "select_city", "select_area");
</script>
</body>
</html>
核心是一個 region_init 函式,共六個參數:前三個是三個下拉選單的 ID,後三個是省、市、區的預設值。後三個參數可以省略;不傳時每個選單會停在第一個選項,要指定預設值就傳入對應的行政區 ID。
var region_init = function (_region_p, _region_c, _region_d,
_region_p_default, _region_c_default, _region_d_default) {
var region_p = document.getElementById(_region_p);
var region_c = document.getElementById(_region_c);
var region_d = document.getElementById(_region_d);
// 依 value 反查並選中對應的 option
function option_items_select(cmb, value) {
for (var i = 0; i < cmb.options.length; i++) {
if (cmb.options[i].value == value) {
cmb.selectedIndex = i;
return;
}
}
}
// 附加 option,同時把該節點的資料物件掛在 option 上,方便後續取用
function option_items_add(cmb, value, text, obj, i) {
var option = document.createElement("OPTION");
cmb.options.add(option);
option.innerText = text;
option.value = value;
option.obj = obj;
}
// 市改變 → 重填區
function region_c_change() {
region_d.options.length = 0;
if (region_c.selectedIndex == -1) return;
var item = region_c.options[region_c.selectedIndex].obj;
for (var i = 0; i < item.district.length; i++) {
option_items_add(region_d, item.district[i].id, item.district[i].name, null, i);
}
option_items_select(region_d, _region_d_default);
}
// 省改變 → 重填市,再連帶重填區
function region_p_change() {
region_c.options.length = 0;
region_c.onchange = null;
if (region_p.selectedIndex == -1) return;
var item = region_p.options[region_p.selectedIndex].obj;
for (var i = 0; i < item.city.length; i++) {
option_items_add(region_c, item.city[i].id, item.city[i].name, item.city[i], i);
}
option_items_select(region_c, _region_c_default);
region_c_change();
region_c.onchange = region_c_change;
}
for (var i = 0; i < province_enum.length; i++) {
option_items_add(region_p, province_enum[i].id, province_enum[i].name, province_enum[i]);
}
option_items_select(region_p, _region_p_default);
region_p_change();
region_p.onchange = region_p_change;
}
這段程式碼有幾個值得注意的設計:
· 資料物件直接掛在 option 上。不必再依 value 去查表,取目前選項的 .obj 就能拿到下層資料。
· 重填前先解除 onchange。程式化改動 selectedIndex 時不會觸發 change 事件,但解除綁定可以避免後續被誤觸。
· 連鎖初始化。region_p_change() 填完市之後直接呼叫 region_c_change(),讓三層一次到位,這也是預設值能正確回顯的關鍵。
· option.innerText 只有 IE 支援,若要跨瀏覽器,改成 option.text = text 或 option.textContent = text 更安全。
資料以嵌套陣列描述:省 → city → district,每個節點都有 id 與 name。以下以前兩個省市為例:
var province_enum = [
{ id: 1, name: '北京', city: [
{ id: 1, name: '北京市', district: [
{ id: 1, name: '東城區' }, { id: 2, name: '西城區' },
{ id: 3, name: '崇文區' }, { id: 4, name: '宣武區' },
{ id: 5, name: '朝陽區' }, { id: 6, name: '豐台區' },
{ id: 7, name: '石景山區' }, { id: 8, name: '海澱區' },
{ id: 9, name: '門頭溝區' }, { id: 10, name: '房山區' },
{ id: 11, name: '通州區' }, { id: 12, name: '順義區' },
{ id: 13, name: '昌平區' }, { id: 14, name: '大興區' },
{ id: 15, name: '懷柔區' }, { id: 16, name: '平谷區' },
{ id: 17, name: '密雲縣' }, { id: 18, name: '延慶縣' }
]}
]},
{ id: 2, name: '天津', city: [
{ id: 2, name: '天津市', district: [
{ id: 19, name: '和平區' }, { id: 20, name: '河東區' },
{ id: 21, name: '河西區' }, { id: 22, name: '南開區' },
{ id: 23, name: '河北區' }, { id: 24, name: '紅橋區' },
{ id: 25, name: '塘沽區' }, { id: 26, name: '漢沽區' },
{ id: 27, name: '大港區' }, { id: 28, name: '東麗區' },
{ id: 29, name: '西青區' }, { id: 30, name: '津南區' },
{ id: 31, name: '北辰區' }, { id: 32, name: '武清區' },
{ id: 33, name: '寶坻區' }, { id: 34, name: '寧河縣' },
{ id: 35, name: '靜海縣' }, { id: 36, name: '薊縣' }
]}
]}
// 其餘 32 個省級行政區(河北、山西、遼寧、吉林、黑龍江、江蘇、浙江、安徽、
// 福建、江西、山東、河南、湖北、湖南、廣東、廣西、海南、重慶、四川、貴州、
// 雲南、西藏、陝西、甘肅、青海、寧夏、新疆、香港、澳門、台灣等)結構完全相同,
// 皆為「省 → city 陣列 → district 陣列」三層嵌套,id 全表連號遞增,此處從略。
];
若要快速上線、且不排斥 jQuery,方法一最省事。若希望零依賴、或專案已不用 jQuery,方法二只需要一份資料檔與一個初始化函式,整體體積小得多。
另外提醒兩點實務經驗:一是行政區資料會隨時間變動(名稱修改、行政區劃調整),建議把 province_enum 抽到獨立 JSON 檔或改由後端 API 提供,避免資料與程式碼綁死;二是三層 select 在行動裝置上逐層點選頗費手,若表單允許,改用「行政區選擇彈窗」或輸入框搭配自動完成,往往比三個下拉選單更好用。