萬盛學電腦網

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

JavaScript 動態新增與刪除 Select Option 選項的標準做法

核心 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
copyright © 萬盛學電腦網 all rights reserved