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

cityData.js,易於維護與擴充(可換成縣市/區、國家/省等)。city.css 與 city.js。<div id="city-picker"></div>new CityPicker({el: '#city-picker'}).init();picker.on('change', function(data){ console.log(data.province, data.city); });| 選項 | 型別 | 預設值 | 說明 |
|---|---|---|---|
| el | String/Element | 必填 | 掛載容器選擇器或 DOM 元素 |
| data | Array | 內建省市資料 | 自訂層級資料,格式:[{name: '省', children: [{name: '市'}, ...]}, ...] |
| placeholder | Array | ['請選擇省份', '請選擇城市'] | 預設提示文字 |
| value | Array | [] | 預設值,如 ['台灣省', '台北市'] |
這套選擇器已在多個正式專案驗證穩定,歡迎 Fork、Star 或提出 Issue 共同完善。若需三級聯動(縣市/區),只需擴充 data 結構並微調樣式即可無縫升級。