萬盛學電腦網

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

JavaScript 二級聯動下拉選單:省市/分類子分類經典實作與現代化重構

經典實作 (原生 JS,兼容 IE6+)

<select id="province" onchange="loadCities(this.value)">
    <option value="">請選擇省份</option>
    <option value="北京">北京</option>
    <option value="上海">上海</option>
    <option value="廣東">廣東</option>
</select>

<select id="city">
    <option value="">請選擇城市</option>
</select>

<script>
var cityMap = {
    '北京': ['東城區','西城區','朝陽區','海淀區'],
    '上海': ['黃浦區','徐匯區','長寧區','靜安區'],
    '廣東': ['廣州市','深圳市','珠海市','佛山市']
};

function loadCities(province) {
    var citySel = document.getElementById('city');
    citySel.options.length = 0; // 清空
    citySel.options[0] = new Option('請選擇城市', '');

    var cities = cityMap[province] || [];
    for (var i = 0; i < cities.length; i++) {
        citySel.options[i+1] = new Option(cities[i], cities[i]);
    }
}
</script>

jQuery 版本 (簡潔、鏈式)

var cityData = {
    '北京': [{id:'d1', name:'東城區'}, {id:'d2', name:'西城區'}],
    '上海': [{id:'s1', name:'黃浦區'}, {id:'s2', name:'徐匯區'}]
};

$('#province').change(function() {
    var $city = $('#city').empty().append('');
    var list = cityData[$(this).val()] || [];
    $.each(list, function(i, city) {
        $city.append($('

現代化 ES6 模組化寫法 (零依賴)

// data.js
export const regionData = {
    '110000': {name: '北京', children: {'110101': '東城區', '110102': '西城區'}},
    '310000': {name: '上海', children: {'310101': '黃浦區', '310104': '徐匯區'}}
};

// cascade.js
export function initCascade(provinceSel, citySel, data) {
    const $prov = document.querySelector(provinceSel);
    const $city = document.querySelector(citySel);

    // 填充省份
    Object.entries(data).forEach(([code, prov]) => {
        $prov.append(new Option(prov.name, code));
    });

    $prov.addEventListener('change', () => {
        const code = $prov.value;
        $city.innerHTML = '';
        if (data[code]?.children) {
            Object.entries(data[code].children).forEach(([cCode, cName]) => {
                $city.append(new Option(cName, cCode));
            });
        }
        $city.dispatchEvent(new Event('change')); // 觸發下一級 (如區縣)
    });

    // 初始化
    if ($prov.value) $prov.dispatchEvent(new Event('change'));
}

資料來源:AJAX 動態載入

async function loadProvinces() {
    const resp = await fetch('/api/regions?level=province');
    const data = await resp.json(); // [{code, name}, ...]
    const $prov = document.getElementById('province');
    data.forEach(p => $prov.append(new Option(p.name, p.code)));
}

async function loadCities(provinceCode) {
    const resp = await fetch(`/api/regions?parent=${provinceCode}`);
    const data = await resp.json();
    const $city = document.getElementById('city');
    $city.innerHTML = '';
    data.forEach(c => $city.append(new Option(c.name, c.code)));
}

document.getElementById('province').addEventListener('change', e => loadCities(e.target.value));
// 初始化
loadProvinces().then(() => {
    // 可預設選中某省份
    // document.getElementById('province').value = '110000';
    // document.getElementById('province').dispatchEvent(new Event('change'));
});

進階需求與解決方案

需求方案
三級/多級聯動 (省-市-區)遞迴相同邏輯,change 事件鏈式觸發下一級
搜尋/過濾選項 (選項過多)使用 Select2, Choices.js, Tom Select 等支援搜尋、AJAX、分組的元件
表單驗證聯動子級變更時重置驗證狀態,required 條件隨父級變化
URL 狀態同步 (分享連結)選擇變更時 history.replaceState 更新 URL 查詢參數,載入時解析還原
無障礙aria-controls 關聯下一級、aria-live 播報選項數量、鍵盤完整操作

總結

二級聯動核心:「父級 change → 清空子級 → 依父級值查資料 → 填充子級」。現代開發採用 fetch + 原生 DOM API 或成熟 UI 庫,資料結構建議標準化 (code/name/children),支援多級擴展與 URL 狀態同步。

copyright © 萬盛學電腦網 all rights reserved