<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>
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($('
// 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'));
}
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 狀態同步。