萬盛學電腦網

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

JavaScript 省市二級聯動下拉選單完整實現(含全國數據)

省市聯動是中文 Web 表單的標配功能。本文提供原生 JavaScript 完整實現,包含全國 34 省級行政區及城市數據、初始化邏輯、事件綁定、動態渲染,可直接落地項目。

數據結構設計

使用數組存儲省份對象,每省包含名稱與城市列表(管道符分隔字符串,節省體積):


var provinces = [
    {name: "請選擇省份", cities: "請選擇城市"},
    {name: "北京", cities: "東城|西城|朝陽|豐台|石景山|海澱|門頭溝|房山|通州|順義|昌平|大興|平谷|懷柔|密雲|延慶"},
    {name: "上海", cities: "黃浦|徐匯|長寧|靜安|普陀|閘北|虹口|楊浦|閔行|寶山|嘉定|浦東|金山|松江|青浦|奉賢|崇明"},
    {name: "天津", cities: "和平|河東|河西|南開|河北|紅橋|東麗|津南|西青|北辰|武清|寶坻|寧河|靜海|薊州"},
    {name: "重慶", cities: "萬州|涪陵|渝中|大渡口|江北|沙坪壩|九龍坡|南岸|北碚|綦江|大足|渝北|巴南|黔江|長壽|江津|合川|永川|南川|璧山|銅梁|潼南|榮昌|開州|梁平|武隆|城口|豐都|墊江|忠縣|雲陽|奉節|巫山|巫溪|石柱|秀山|酉陽|彭水"},
    // ... 其餘 30 省份數據(完整數據見代碼附錄)
    {name: "香港", cities: ""},
    {name: "澳門", cities: ""},
    {name: "台灣", cities: "台北|高雄|台中|台南|屏東|南投|雲林|新竹|彰化|苗栗|嘉義|花蓮|桃園|宜蘭|基隆|台東|金門|馬祖|澎湖"},
    {name: "其它", cities: "北美洲|南美洲|亞洲|非洲|歐洲|大洋洲"}
];

完整 HTML + JS 實現


<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>省市二級聯動</title>
    <style>
        .form-group { margin: 15px 0; }
        label { display: inline-block; width: 80px; text-align: right; margin-right: 10px; }
        select { padding: 8px 12px; font-size: 14px; border: 1px solid #ddd; border-radius: 4px; min-width: 200px; }
    </style>
</head>
<body>
    <div class="form-group">
        <label>省份:</label>
        <select id="province"></select>
    </div>
    <div class="form-group">
        <label>城市:</label>        <select id="city"></select>
    </div>
    <div class="form-group">
        <label>完整地址:</label>
        <input type="text" id="fullAddress" readonly style="width:300px; background:#f5f5f5;">
    </div>

    <script>
    // 省市數據(完整 34 省份,此處省略部分,完整版見下方附錄)
    var provinceData = [ /* ... 上方數據 ... */ ];

    var $province = document.getElementById("province");
    var $city = document.getElementById("city");
    var $address = document.getElementById("fullAddress");

    // 1. 初始化省份下拉
    function initProvince() {
        provinceData.forEach(function(p, index) {
            var option = document.createElement("option");
            option.value = index; // 使用索引作為 value,避免特殊字符
            option.textContent = p.name;
            $province.appendChild(option);
        });
    }

    // 2. 根據省份索引更新城市下拉
    function updateCities(provinceIndex) {
        // 清空城市選項
        $city.innerHTML = "";

        if (provinceIndex <= 0 || provinceIndex >= provinceData.length) {
            var defaultOpt = document.createElement("option");
            defaultOpt.value = "";
            defaultOpt.textContent = "請選擇城市";
            $city.appendChild(defaultOpt);
            $city.disabled = true;
            return;
        }

        var cities = provinceData[provinceIndex].cities.split("|");
        $city.disabled = false;

        cities.forEach(function(cityName, i) {
            var option = document.createElement("option");
            option.value = cityName;
            option.textContent = cityName;
            $city.appendChild(option);
        });

        // 默認選中第一個城市
        if (cities.length > 0) {
            $city.selectedIndex = 0;
            updateAddress();
        }
    }

    // 3. 更新完整地址顯示
    function updateAddress() {
        var provinceName = $province.options[$province.selectedIndex].text;
        var cityName = $city.value;
        $address.value = provinceName + (cityName ? " " + cityName : "");
    }

    // 4. 綁定事件
    $province.onchange = function() {
        updateCities(this.selectedIndex);
    };

    $city.onchange = updateAddress;

    // 5. 初始化
    initProvince();
    updateCities(0); // 初始化城市為「請選擇」
    </script>
</body>
</html>

完整省份數據附錄(可直接複製)


var provinceData = [
    {name: "請選擇省份", cities: "請選擇城市"},
    {name: "北京", cities: "東城|西城|朝陽|豐台|石景山|海澱|門頭溝|房山|通州|順義|昌平|大興|平谷|懷柔|密雲|延慶"},
    {name: "上海", cities: "黃浦|徐匯|長寧|靜安|普陀|閘北|虹口|楊浦|閔行|寶山|嘉定|浦東|金山|松江|青浦|奉賢|崇明"},
    {name: "天津", cities: "和平|河東|河西|南開|河北|紅橋|東麗|津南|西青|北辰|武清|寶坻|寧河|靜海|薊州"},
    {name: "重慶", cities: "萬州|涪陵|渝中|大渡口|江北|沙坪壩|九龍坡|南岸|北碚|綦江|大足|渝北|巴南|黔江|長壽|江津|合川|永川|南川|璧山|銅梁|潼南|榮昌|開州|梁平|武隆|城口|豐都|墊江|忠縣|雲陽|奉節|巫山|巫溪|石柱|秀山|酉陽|彭水"},
    {name: "河北", cities: "石家莊|唐山|秦皇島|邯鄲|邢台|保定|張家口|承德|滄州|廊坊|衡水"},
    {name: "山西", cities: "太原|大同|陽泉|長治|晉城|朔州|呂梁|忻州|晉中|臨汾|運城"},
    {name: "內蒙古", cities: "呼和浩特|包頭|烏海|赤峰|通遼|鄂爾多斯|呼倫貝爾|巴彥淖爾|烏蘭察布|興安|錫林郭勒|阿拉善"},
    {name: "遼寧", cities: "沈陽|大連|鞍山|撫順|本溪|丹東|錦州|營口|阜新|遼陽|盤錦|鐵嶺|朝陽|葫蘆島"},
    {name: "吉林", cities: "長春|吉林|四平|遼源|通化|白山|松原|白城|延邊"},
    {name: "黑龍江", cities: "哈爾濱|齊齊哈爾|鶴崗|雙鴨山|雞西|大慶|伊春|佳木斯|七台河|牡丹江|黑河|綏化|大興安嶺"},
    {name: "江蘇", cities: "南京|無錫|徐州|常州|蘇州|南通|連雲港|淮安|鹽城|揚州|鎮江|泰州|宿遷"},
    {name: "浙江", cities: "杭州|寧波|溫州|嘉興|湖州|紹興|金華|衢州|舟山|台州|麗水"},
    {name: "安徽", cities: "合肥|蕪湖|蚌埠|淮南|馬鞍山|淮北|銅陵|安慶|黃山|滁州|阜陽|宿州|巢湖|六安|宣城|亳州|池州"},
    {name: "福建", cities: "福州|廈門|莆田|三明|泉州|漳州|南平|龍巖|寧德"},
    {name: "江西", cities: "南昌|景德鎮|萍鄉|九江|新餘|鷹潭|贛州|吉安|宜春|撫州|上饒"},
    {name: "山東", cities: "濟南|青島|淄博|棗莊|東營|煙台|濰坊|濟寧|泰安|威海|日照|臨沂|德州|聊城|濱州|菏澤"},
    {name: "河南", cities: "鄭州|開封|洛陽|平頂山|安陽|鶴壁|新鄉|焦作|濮陽|許昌|漯河|三門峽|南陽|商丘|信陽|周口|駐馬店|濟源"},
    {name: "湖北", cities: "武漢|黃石|十堰|宜昌|襄陽|鄂州|荊門|孝感|荊州|黃岡|咸寧|隨州|恩施|仙桃|潛江|天門|神農架"},
    {name: "湖南", cities: "長沙|株洲|湘潭|衡陽|邵陽|岳陽|常德|張家界|益陽|郴州|永州|懷化|婁底|湘西"},
    {name: "廣東", cities: "廣州|韶關|深圳|珠海|汕頭|佛山|江門|湛江|茂名|肇慶|惠州|梅州|汕尾|河源|陽江|清遠|東莞|中山|潮州|揭陽|雲浮"},
    {name: "廣西", cities: "南寧|柳州|桂林|梧州|北海|防城港|欽州|貴港|玉林|百色|賀州|河池|來賓|崇左"},
    {name: "海南", cities: "海口|三亞|三沙|儋州|五指山|瓊海|文昌|萬寧|東方|定安|屯昌|澄邁|臨高|白沙|昌江|樂東|瓊中"},
    {name: "四川", cities: "成都|自貢|攀枝花|瀘州|德陽|綿陽|廣元|遂寧|內江|樂山|南充|眉山|宜賓|廣安|達州|雅安|巴中|資陽|阿壩|甘孜|涼山"},
    {name: "貴州", cities: "貴陽|六盤水|遵義|安順|畢節|銅仁|黔西南|黔東南|黔南"},
    {name: "雲南", cities: "昆明|曲靖|玉溪|保山|昭通|麗江|普洱|臨滄|楚雄|紅河|文山|西雙版納|大理|德宏|怒江|迪慶"},
    {name: "西藏", cities: "拉薩|日喀則|昌都|林芝|山南|那曲|阿裡"},
    {name: "陝西", cities: "西安|銅川|寶雞|咸陽|渭南|延安|漢中|榆林|安康|商洛"},
    {name: "甘肅", cities: "蘭州|嘉峪關|金昌|白銀|天水|武威|張掖|平涼|酒泉|慶陽|定西|隴南|臨夏|甘南"},
    {name: "青海", cities: "西寧|海東|海北|黃南|海南|果洛|玉樹|海西"},
    {name: "寧夏", cities: "銀川|石嘴山|吳忠|固原|中衛"},
    {name: "新疆", cities: "烏魯木齊|克拉瑪依|吐魯番|哈密|昌吉|博爾塔拉|巴音郭勒|阿克蘇|克孜勒蘇|喀什|和田|伊犁|塔城|阿勒泰|石河子|阿拉爾|圖木舒克|五家渠|北屯|鐵門關|雙河|可克達拉|昆玉|胡楊河"},
    {name: "香港", cities: ""},
    {name: "澳門", cities: ""},
    {name: "台灣", cities: "台北|高雄|台中|台南|屏東|南投|雲林|新竹|彰化|苗栗|嘉義|花蓮|桃園|宜蘭|基隆|台東|金門|馬祖|澎湖"},
    {name: "其它", cities: "北美洲|南美洲|亞洲|非洲|歐洲|大洋洲"}
];

jQuery 版本(更簡潔)


$(function() {
    var $province = $("#province");
    var $city = $("#city");

    // 初始化省份
    $.each(provinceData, function(i, p) {
        $province.append($("

現代化改進方向

  1. 數據分離:將省市數據單獨維護為 JSON 文件,構建時打包或運行時加載
  2. 搜索增強:城市多時接入 Select2、Choices.js 支持搜索過濾
  3. 三級聯動:擴展區/縣數據,邏輯同理
  4. TypeScript 類型:定義 `ProvinceData` 接口,獲得 IDE 提示
  5. 無障礙:添加 `aria-label`、鍵盤導航、螢幕閱讀器支持

這套原生實現零依賴、體積極小(數據約 15KB)、兼容性極佳,是中後台表單系統的理想選擇。

copyright © 萬盛學電腦網 all rights reserved