萬盛學電腦網

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

打造實用的 JavaScript 省市二級聯動選擇器(含完整原始碼與 Demo)

專案背景

網路上現成的省市選擇器或許多、或過時、或不支援行動裝置。本專案針對實務需求,自行開發一套輕量、無相依、支援觸控、響應式的省市二級聯動選擇器,並開源完整原始碼供開發者直接整合。

介面預覽

省市選擇器介面示意圖

原始碼結構

專案目錄結構圖

快速體驗

核心特色

  • 純原生 JS,零依賴,壓縮後不足 3 KB。
  • 資料分離:省市資料獨立為 cityData.js,易於維護與擴充(可換成縣市/區、國家/省等)。
  • 觸控優化:支援觸控滑動選擇、點擊外部關閉、鍵盤無障礙操作。
  • 多實例共存:同一頁面可放置多組選擇器,互不干擾。

整合步驟(3 分鐘上手)

  1. 引入 city.css 與 city.js。
  2. 在 HTML 放置容器:<div id="city-picker"></div>
  3. 初始化:new CityPicker({el: '#city-picker'}).init();
  4. 監聽變更事件取得選值:picker.on('change', function(data){ console.log(data.province, data.city); });

自訂選項速查表

選項型別預設值說明
elString/Element必填掛載容器選擇器或 DOM 元素
dataArray內建省市資料自訂層級資料,格式:[{name: '省', children: [{name: '市'}, ...]}, ...]
placeholderArray['請選擇省份', '請選擇城市']預設提示文字
valueArray[]預設值,如 ['台灣省', '台北市']

結語

這套選擇器已在多個正式專案驗證穩定,歡迎 Fork、Star 或提出 Issue 共同完善。若需三級聯動(縣市/區),只需擴充 data 結構並微調樣式即可無縫升級。

copyright © 萬盛學電腦網 all rights reserved