核心 API 速查
var select = document.getElementById('mySelect');
// 清空所有選項 (最快)
select.options.length = 0;
// 刪除單一選項 (索引)
select.remove(index);
// 或
select.options.remove(index);
// 新增選項到末尾
select.add(new Option(text, value));
// 或指定插入位置
select.add(new Option(text, value), select.options[index]);
// 修改選項
select.options[index] = new Option(newText, newValue);
完整封裝工具函式
/**
* Select 操作工具類
*/
var SelectUtil = {
// 取得 Select 元素
get: function(id) {
return document.getElementById(id);
},
// 清空並可選保留前 N 項 (如提示項)
clear: function(select, keepFirstN = 0) {
var len = select.options.length;
for (var i = len - 1; i >= keepFirstN; i--) {
select.remove(i);
}
},
// 新增單一選項
add: function(select, text, value, index) {
var opt = new Option(text, value === undefined ? text : value);
if (index !== undefined && index < select.options.length) {
select.add(opt, select.options[index]);
} else {
select.add(opt);
}
return opt;
},
// 批次新增 (陣列/物件)
addRange: function(select, items, textKey, valueKey) {
var frag = document.createDocumentFragment();
items.forEach(function(item) {
var text = textKey ? item[textKey] : item;
var value = valueKey ? item[valueKey] : item;
frag.appendChild(new Option(text, value));
});
select.appendChild(frag);
},
// 依值刪除
removeByValue: function(select, value) {
for (var i = select.options.length - 1; i >= 0; i--) {
if (select.options[i].value === value) select.remove(i);
}
},
// 依文字刪除
removeByText: function(select, text) {
for (var i = select.options.length - 1; i >= 0; i--) {
if (select.options[i].text === text) select.remove(i);
}
},
// 設定選中值
setValue: function(select, value) {
select.value = value;
},
// 取得選中值
getValue: function(select) {
return select.value;
},
// 取得選中文字
getText: function(select) {
var i = select.selectedIndex;
return i >= 0 ? select.options[i].text : '';
},
// 判斷值是否存在
hasValue: function(select, value) {
for (var i = 0; i < select.options.length; i++) {
if (select.options[i].value === value) return true;
}
return false;
}
};
實戰範例:動態載入城市/地區
<select id="city"><option value="">請選擇縣市</option></select>
<select id="district" disabled><option value="">請先選縣市</option></select>
<script>
var cityData = [
{ code: 'TP', name: '台北市', districts: ['中正','大同','中山','松山','大安','萬華','信義','士林','北投','內湖','南港','文山'] },
{ code: 'TC', name: '台中市', districts: ['中區','東區','南區','西區','北區','西屯','南屯','北屯','豐原','大里','太平'] }
];
var $city = $('#city');
var $district = $('#district');
// 初始化縣市
cityData.forEach(function(c) {
$city.append(new Option(c.name, c.code));
});
$city.on('change', function() {
var code = this.value;
SelectUtil.clear($district[0], 1); // 保留第一項提示
if (code) {
var city = cityData.find(c => c.code === code);
if (city) {
SelectUtil.addRange($district[0], city.districts);
$district.prop('disabled', false);
}
} else {
$district.prop('disabled', true);
}
});
</script>
常見錯誤與避坑指南
| 錯誤寫法 | 問題 | 正確寫法 |
select.options.add(opt) | IE 專屬,非標準 | select.add(opt) |
select.options[i] = new Option() 後未移除舊項 | 索引位置替換而非新增 | 用 select.add() 或 appendChild() |
正向迴圈 for(i=0;i 刪除 | 索引偏移導致漏刪 | 反向迴圈 for(i=len-1;i>=0;i--) |
重複 id 屬性 | HTML 無效、查詢錯誤 | Option 不需 id,用 value 區分 |
select.value = 'x' 但無對應 option | 無效,selectedIndex 變 -1 | 先確認存在或新增 |
現代框架整合提示
// Vue 3
// React
// 重點:框架處理資料綁定,不直接操作 DOM
// 需操作 DOM 時用 ref + 原生 API