DIV CSS 佈局教程網

中國地區三級聯動下拉選單實作解析:資料結構、遞迴渲染與頁面整合
編輯:關於JavaScript     

做過表單的人大概都遇過這個需求:使用者要填地址,我們希望他先選省份、再選城市、最後選区县,而且上一層一改,下一層就得跟著重來。公司內部的框架雖然早就把這件事包好了,但封裝太厚的時候反而看不清原理,於是自己翻了不少資料,把最經典的「JS 資料表 + 遞迴 change」寫法重新整理了一遍,順手記下來,之後要抄也方便。

一、資料該怎麼擺

三級聯動的本質其實是一棵樹,而 JavaScript 裡表示樹最省事的辦法,就是用「路徑字串」當索引。第一層用 0,第二層用 0_0,第三層用 0_0_0,每一段數字代表上層選單被選到的下標(減一之後的值)。這樣只要把使用者的選擇一路接起來,就能直接查表,完全不需要事先建立複雜的節點物件。

承載這些資料的是一個很薄的外殼:

function Dsy() {
  this.Items = {};
}

Dsy.prototype.add = function (id, iArray) {
  this.Items[id] = iArray;
};

Dsy.prototype.Exists = function (id) {
  if (typeof (this.Items[id]) == "undefined") return false;
  return true;
};

var dsy = new Dsy();

接著就是往裡頭塞資料,形式一律是 dsy.add(路徑, [選項文字陣列]):

dsy.add("0", ["安徽","北京","福建","甘肅","廣東","廣西","貴州","海南","河北","河南","黑龍江","湖北","湖南","吉林","江蘇","江西","遼寧","內蒙古","寧夏","青海","山東","山西","陝西","上海","四川","天津","西藏","新疆","雲南","浙江","重慶"]);

dsy.add("0_0", ["安慶","蚌埠","巢湖","池州","滁州","阜陽","合肥","淮北","淮南","黃山","六安","馬鞍山","宿州","銅陵","蕪湖","宣城","亳州"]);
dsy.add("0_0_0", ["安慶市","懷寧縣","潛山縣","宿松縣","太湖縣","桐城市","望江縣","岳西縣","枞陽縣"]);
dsy.add("0_0_1", ["蚌埠市","固鎮縣","懷遠縣","五河縣"]);

dsy.add("0_1", ["北京"]);
dsy.add("0_1_0", ["北京市","密雲縣","延慶縣"]);

dsy.add("0_4", ["潮州","東莞","佛山","廣州","河源","惠州","江門","揭陽","茂名","梅州","清遠","汕頭","汕尾","韶關","深圳","陽江","雲浮","湛江","肇慶","中山","珠海"]);
dsy.add("0_4_14", ["深圳市"]);
dsy.add("0_4_20", ["珠海市"]);

其餘各省就照同樣規則一路補下去。這份資料網路上到處都有,缺點是行政區劃一旦調整就容易過期,實戰時建議直接用最新的官方行政區資料重新產生一份 JS,別硬扛舊表。

二、change 函式:整份程式唯一的智慧所在

真正需要理解的只有這段。它接收「要更新第幾層」當參數,先把前面各層的選擇拼成路徑,清空目標 select,補上提示項,如果父層有選(或本來就是第一層)而且查表命中,就把子選項逐一塞進去,最後再遞迴處理下一層。

var s = ["province", "city", "county"];
var opt0 = ["省份", "地級市", "市、縣級市、縣"];

function change(v) {
  var str = "0";
  for (var i = 0; i < v; i++) {
    str += ("_" + (document.getElementById(s[i]).selectedIndex - 1));
  }

  var ss = document.getElementById(s[v]);
  ss.length = 0;
  ss.options[0] = new Option(opt0[v], opt0[v]);

  if ((v && document.getElementById(s[v - 1]).selectedIndex > 0) || !v) {
    if (dsy.Exists(str)) {
      var ar = dsy.Items[str];
      for (var i = 0; i < ar.length; i++) {
        ss.options[ss.length] = new Option(ar[i], ar[i]);
      }
      if (v) ss.options[1].selected = true;
    }
  }

  if (++v < s.length) change(v);
}

幾個容易踩到的細節:

  • 路徑的第一段固定是 "0",因為 dsy.add("0", ...) 存的就是全國列表;後面每一段則是 selectedIndex - 1,減一的目的是跳過「請選擇」那個提示項。
  • ss.length = 0 一定要在新增 option 之前,否則舊選項會殘留。
  • if (v) options[1].selected = true 這句讓新展開的這一層預設停在第一個真實選項上,而不是提示文字,用起來順手很多。
  • 遞迴的終止條件是 v 走到 s.length,所以三層、四層都吃,不必改結構。

三、頁面端只需要三個 select

HTML 這邊乾淨得讓人意外,三個空 select 加上一次初始化呼叫就夠了:

<label>所在地:</label>
<select id="province" name="province"></select>
<select id="city" name="city"></select>
<select id="county" name="county"></select>

<script type="text/javascript" src="js/area.js"></script>
<script type="text/javascript">
  setup();
</script>
function setup() {
  for (var i = 0; i < s.length - 1; i++) {
    document.getElementById(s[i]).onchange = new Function("change(" + (i + 1) + ")");
  }
  change(0);
}

最外層的省份不需要綁事件,因為 change(0) 已經在初始化時跑過一次,把全國列表填進去了;從省份開始每一層都要綁 onchange,觸發下一層重建。

四、幾個實務上的提醒

  • 表單要能回填。原始寫法只處理「即時選擇」,如果要做編輯頁,記得在 setup() 之後依序設定三層的 value,並逐層觸發 change,順序錯了會被洗掉。
  • 別把整份資料塞進頁面。三萬多筆縣區資料直接寫在 JS 裡,首屏 will be noticeably 變慢。資料量大的時候改成「選完省份再 Ajax 抓下一層」會漂亮很多。
  • 命名要對齊後端。name 屬性盡量用 province / city / county 這類後端看得懂的欄位名,原範例裡 county 那層誤寫成 name="city",實作時很容易複製這個錯。
  • 可訪問性。純 select 的解法對鍵盤與螢幕閱讀器都友善,這點比自製下拉美化的方案要好,能保留就保留。

整體看起來,這套寫法最大的優點是「資料與邏輯分離」:只要 Dsy 的資料表正確,換省、換國家、換成四層行政區,都只需要改 s 陣列的長度,change 一行都不用動。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved