萬盛學電腦網

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

JavaScript Select/Option 操作完整指南:原生 DOM 與 jQuery 雙軌實戰

Select/Option DOM 結構基礎




// DOM 結構
// HTMLSelectElement
//   .options : HTMLOptionsCollection (類陣列)
//   .selectedIndex : number (-1 表示無選擇)
//   .value : 字串 (目前選中 option 的 value)
//   .length : number
//
// HTMLOptionElement
//   .value : 字串
//   .text : 字串 (顯示文字)
//   .selected : boolean
//   .index : number
//   .defaultSelected : boolean (初始 HTML selected 屬性)

原生 DOM API 完整操作

查詢與讀取


var sel = document.getElementById('city');

// 取得選中值
var val = sel.value; // "tc"

// 取得選中索引
var idx = sel.selectedIndex; // 1

// 取得選中 Option 元素
var opt = sel.options[sel.selectedIndex]; // 
var text = opt.text; // "台中市"

// 取得所有選項文字陣列
var texts = Array.from(sel.options).map(o => o.text); // ["台北市", "台中市", "高雄市"]

// 取得所有值陣列
var values = Array.from(sel.options).map(o => o.value); // ["tp", "tc", "kh"]

新增選項


// 方法 1:Option 建構子 (最簡潔、標準)
var opt = new Option('台南市', 'tn'); // (text, value, defaultSelected, selected)
sel.add(opt); // 附加到末尾
// 或指定位置:sel.add(opt, sel.options[1]); // 插入到索引 1 之前

// 方法 2:createElement (較繁瑣)
var opt = document.createElement('option');
opt.value = 'tn';
opt.textContent = '台南市';
sel.appendChild(opt);

// 方法 3:直接操作 options 集合 (舊式)
sel.options[sel.options.length] = new Option('台南市', 'tn');

修改選項


// 修改目前選中項
sel.options[sel.selectedIndex].text = '新文字';
sel.options[sel.selectedIndex].value = 'new_val';

// 修改指定索引
sel.options[1] = new Option('新台中', 'tc_new'); // 替換

// 修改指定 value 的項 (需搜尋)
for (var i = 0; i < sel.options.length; i++) {
    if (sel.options[i].value === 'tc') {
        sel.options[i].text = '台中市 (更新)';
        break;
    }
}

刪除選項


// 刪除目前選中
sel.remove(sel.selectedIndex);

// 刪除指定索引
sel.remove(0);

// 刪除指定 value
for (var i = sel.options.length - 1; i >= 0; i--) { // 反向避免索引偏移
    if (sel.options[i].value === 'tc') sel.remove(i);
}

// 清空所有
sel.options.length = 0; // 最快
// 或
while (sel.options.length) sel.remove(0);

動態綁定資料 (AJAX 範例)


function loadCities(selector, apiUrl, defaultValue) {
    var sel = document.getElementById(selector);
    sel.options.length = 0; // 清空
    
    fetch(apiUrl)
        .then(r => r.json())
        .then(data => {
            data.forEach(function(item) {
                sel.add(new Option(item.name, item.id));
            });
            if (defaultValue) sel.value = defaultValue;
        });
}

jQuery 封裝操作 (舊專案維護用)


var $sel = $('#city');

// 取值
$sel.val(); // "tc"

// 取文字
$sel.find('option:selected').text(); // "台中市"

// 新增
$sel.append(new Option('台南市', 'tn'));
// 或
$sel.append('');

// 修改選中項文字
$sel.find('option:selected').text('新文字');

// 刪除選中項
$sel.find('option:selected').remove();

// 刪除指定 value
$sel.find('option[value="tc"]').remove();

// 清空
$sel.empty();
// 或保留第一個提示項
$sel.find('option:not(:first)').remove();

// 綁定 change 事件
$sel.on('change', function() {
    console.log('選中:', this.value, $(this).find('option:selected').text());
});

二級聯動選單實作 (縣市 -> 鄉鎮區)


var areaData = {
    'tp': ['中正區', '大同區', '中山區', ...],
    'tc': ['中區', '東區', '南區', ...],
    'kh': ['新興區', '前金區', '苓雅區', ...]
};

$('#city').on('change', function() {
    var cityCode = this.value;
    var $district = $('#district');
    $district.empty().append('');
    
    if (areaData[cityCode]) {
        areaData[cityCode].forEach(function(name) {
            $district.append(new Option(name, name));
        });
    }
    $district.prop('disabled', !cityCode);
});

// 初始化觸發
$('#city').trigger('change');

進階:多選 Select (multiple)




// 取得所有選中值 (陣列)
var selected = Array.from(document.getElementById('skills').selectedOptions)
    .map(o => o.value); // ["js", "vue"]

// jQuery
$('#skills').val(); // ["js", "vue"] 自動回傳陣列

// 全選/全不選
function toggleAll(selectId, check) {
    var opts = document.getElementById(selectId).options;
    for (var i = 0; i < opts.length; i++) opts[i].selected = check;
}

效能優化:大量選項 (1000+)

  • 使用 DocumentFragment 批次建立再一次 appendChild
  • 虛擬滾動/搜尋過濾 (Select2、Choices.js、Tom Select)
  • 避免頻繁操作 DOM,改用 innerHTML 字串拼接後一次 innerHTML = html (注意 XSS)

現代化建議

新專案建議使用成熟選單元件庫:

  • Tom Select:無依賴、功能完整、支援標籤、搜尋、分組
  • Choices.js:輕量、模組化、無障礙佳
  • Select2:老牌、生態豐富、但需 jQuery
  • Headless UI / Radix UI:React/Vue 無樣式無障礙元件
copyright © 萬盛學電腦網 all rights reserved