萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 實作省市二級聯動下拉選單(DOM 原生實作)

省市二級聯動是表單設計常見需求:選擇省份後,城市下拉選單動態更新對應選項。本文展示純原生 JavaScript + DOM 操作實作,無需 Ajax、無後端依賴,資料直接內嵌於 JS 物件,適合中小型專案或原型快速開發。

資料結構設計

使用物件鍵值對,Key 為省份名稱,Value 為城市陣列:

var provs = {
    "江西省": ["南昌市", "景德鎮", "九江", "鷹潭", "萍鄉", "新馀", "贛州", "吉安", "宜春", "撫州", "上饒"],
    "福建省": ["福州", "廈門", "莆田", "三明", "泉州", "漳州", "南平", "龍巖", "寧德"],
    "河北省": ["石家莊", "邯鄲", "邢台", "保定", "張家口", "承德", "廊坊", "唐山", "秦皇島", "滄州", "衡水"]
};

核心功能函式

1. 頁面載入時載入省份選項

function loadProv() {
    var provSelect = document.getElementById("prov");
    for (var key in provs) {
        var opt = document.createElement("option");
        opt.value = key;
        opt.innerText = key;
        provSelect.appendChild(opt);
    }
}

2. 省份變更時更新城市選單

function provChange() {
    var provSelect = document.getElementById("prov");
    var citySelect = document.getElementById("city");
    var provName = provSelect.value;
    
    // 未選省份時隱藏城市下拉
    if (provName === "none") {
        citySelect.style.display = "none";
        return;
    }
    citySelect.style.display = "";
    
    var cities = provs[provName];
    
    // 清空現有選項(反向迴圈避免索引錯亂)
    for (var i = citySelect.childNodes.length - 1; i >= 0; i--) {
        citySelect.removeChild(citySelect.childNodes[i]);
    }
    // 或簡單粗暴:citySelect.innerHTML = ""; / citySelect.options.length = 0;
    
    // 填入新城市
    for (var i = 0; i < cities.length; i++) {
        var opt = document.createElement("option");
        opt.value = cities[i];
        opt.innerText = cities[i];
        citySelect.appendChild(opt);
    }
}

HTML 結構

<body onload="loadProv()">
    <select id="prov" onchange="provChange()">
        <option value="none">請選擇省</option>
    </select>
    <select id="city" style="display:none"></select>
</body>

進階擴充:三級聯動(省-市-區)

同理擴充資料結構為三層巢狀物件:

var areaData = {
    "江西省": {
        "南昌市": ["東湖區", "西湖區", "青雲譜區", "灣裡區", "青山湖區", "新建區", "南昌縣", "安義縣", "進賢縣"],
        "景德鎮": ["昌江區", "珠山區", "浮梁縣", "樂平市"]
        // ...
    },
    "福建省": {
        "福州": ["鼓樓區", "台江區", "倉山區", "馬尾區", "晉安區", "閩侯縣", "連江縣", "羅源縣", "閩清縣", "永泰縣", "平潭縣", "福清市", "長樂市"],
        // ...
    }
    // ...
};

// 城市選擇後更新區/縣
function cityChange() {
    var cityName = document.getElementById("city").value;
    var districtSelect = document.getElementById("district");
    var districts = areaData[provName][cityName] || [];
    
    districtSelect.innerHTML = "";
    districts.forEach(d => {
        var opt = new Option(d, d);
        districtSelect.add(opt);
    });
    districtSelect.style.display = districts.length ? "" : "none";
}

現代化改寫建議

  1. 資料外部化:將資料放入獨立 JSON 檔,fetch 載入,利於維護與快取
  2. 使用 <select>.options 集合:select.options.add(new Option(text, value)) 比 createElement 更簡潔
  3. 事件綁定改用 addEventListener:避免行內 onchange 污染全域
  4. 封裝為可複用元件:支援多實例、自定義資料源、載入狀態
// ES6 類別封裝範例
class Cascader {
    constructor(provSel, citySel, data) {
        this.prov = document.querySelector(provSel);
        this.city = document.querySelector(citySel);
        this.data = data;
        this.init();
    }
    
    init() {
        this.renderProv();
        this.prov.addEventListener('change', () => this.renderCity());
    }
    
    renderProv() {
        this.prov.innerHTML = '';
        Object.keys(this.data).forEach(p => {
            this.prov.add(new Option(p, p));
        });
    }
    
    renderCity() {
        const prov = this.prov.value;
        this.city.innerHTML = '';
        if (!prov) return this.city.style.display = 'none';
        this.data[prov].forEach(c => this.city.add(new Option(c, c)));
        this.city.style.display = '';
    }
}

// 使用
new Cascader('#prov', '#city', provs);
copyright © 萬盛學電腦網 all rights reserved