萬盛學電腦網

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

JavaScript 實作省市區三級聯動下拉選單(純前端無 Ajax)

省市區三級聯動是註冊表單、收貨地址等場景的標準需求。本文提供兩種純前端實作方式:陣列物件映射法與 Switch-case 硬編碼法,皆無需後端介面、無刷新、資料變動只需調整 JS 即可。適合中小型專案快速落地。

方法一:陣列物件映射法(推薦,資料驅動)

資料結構分離,易維護擴充。

資料定義

// 省 -> 市
var cityList = {
    '江西省': ['南昌市', '撫州市', '上饒市', '鷹潭市', '豐城市', '吉安市'],
    '河南省': ['鄭州市', '洛陽市'],
    '湖北省': ['武漢市', '宜昌市'],
    '福建省': ['福州市', '三明市', '佛山市']
};

// 市 -> 區/縣
var zushu = {
    '南昌市': ['南昌縣', '青雲譜區', '蓮塘鎮'],
    '撫州市': ['臨川區', '雲山鎮', '唱凱鎮']
    // 其他城市補全...
};

核心邏輯

var province = document.getElementById("province");
var city = document.getElementById("city");
var district = document.getElementById("san"); // 原文用 san 代表區/縣

// 初始化省份
for (var p in cityList) {
    province.add(new Option(p, p), null);
}

// 省份變更 -> 更新城市
province.onchange = function() {
    var p = this.value;
    city.options.length = 0;
    city.add(new Option("--請選擇--", ""), null);
    if (cityList[p]) {
        cityList[p].forEach(c => city.add(new Option(c, c), null));
    }
    district.options.length = 0; // 連帶清空區
    district.style.display = cityList[p] ? "" : "none";
};

// 城市變更 -> 更新區/縣
city.onchange = function() {
    var c = this.value;
    district.options.length = 0;
    district.add(new Option("--請選擇--", ""), null);
    if (zushu[c]) {
        zushu[c].forEach(d => district.add(new Option(d, d), null));
        district.style.display = "";
    } else {
        district.style.display = "none";
    }
};

方法二:Switch-case 硬編碼法(不推薦維護)

邏輯寫死在 switch 中,資料與程式碼耦合,擴充極其痛苦,僅供理解邏輯參考。

function ck() {
    var city = document.getElementById("city");
    var num = province.selectedIndex; // 1-based 索引
    city.options.length = 0;
    
    switch(num) {
        case 1: // 江西省
            city.add(new Option("南昌市", "南昌市"), null);
            city.add(new Option("撫州市", "撫州市"), null);
            // ...
            break;
        case 2: // 福建省
            city.add(new Option("廈門市", "廈門市"), null);
            // ...
            break;
        case 3: // 廣東省
            city.add(new Option("廣州市", "廣州市"), null);
            // ...
            break;
    }
    
    // 區/縣同理寫死...
}

HTML 結構

<select id="province" onchange="ck()">
    <option value="">--請選擇--</option>
</select>
<select id="city"><option value="">--請選擇--</option></select>
<select id="san"><option value="">--請選擇--</option></select>

現代化最佳實踐:資料外部化 + 元件化

實際專案強烈建議:

  1. 資料獨立為 JSON:area-data.json 含完整省市區三層資料(可從國家統計局或開源專案獲取)
  2. 封裝為可複用元件:支援 Vue/React/Angular 或原生 Web Component
  3. 支援搜尋/鍵盤導航:選項多時必備
<!-- 現代原生模組化範例 -->
<script type="module">
import areaData from './area-data.json';

class AreaCascader {
    constructor(selectors) {
        this.prov = document.querySelector(selectors.prov);
        this.city = document.querySelector(selectors.city);
        this.dist = document.querySelector(selectors.dist);
        this.data = areaData;
        this.bind();
    }
    
    bind() {
        this.prov.addEventListener('change', () => this.updateLevel('city'));
        this.city.addEventListener('change', () => this.updateLevel('dist'));
    }
    
    updateLevel(level) {
        const target = this[level];
        const parentVal = level === 'city' ? this.prov.value : this.city.value;
        const parentData = level === 'city' ? this.data : this.data[this.prov.value];
        
        target.innerHTML = '';
        if (!parentVal || !parentData[parentVal]) {
            target.style.display = 'none';
            if (level === 'city') this.dist.style.display = 'none';
            return;
        }
        
        parentData[parentVal].forEach(item => target.add(new Option(item, item)));
        target.style.display = '';
        if (level === 'city') this.dist.style.display = 'none';
    }
}

new AreaCascader({ prov: '#province', city: '#city', dist: '#district' });
</script>

資料來源建議

總結

方案優點缺點適用場景
陣列物件映射資料邏輯分離、易擴充資料量大時 JS 檔案過大中小專案、原型開發
Switch-case邏輯直觀維護地獄、極難擴充教學示範、極簡單場景
外部 JSON + 元件化專業、可維護、效能佳需建構工具/模組支援正式產品專案
copyright © 萬盛學電腦網 all rights reserved