<select multiple> 允許用戶通過 Ctrl/Shift 點擊選擇多個選項。獲取其選中值是表單處理的常見需求。本文介紹原生 JS、jQuery、現代 API 多種獲取方式,並對比性能與適用場景。
<select id="multiSelect" name="items" multiple size="6">
<option value="1">選項一</option>
<option value="2" selected>選項二</option>
<option value="3">選項三</option>
<option value="4" selected>選項四</option>
<option value="5">選項五</option>
</select>
<button id="btnGet">獲取選中值</button>
<output id="result"></output>
const select = document.getElementById('multiSelect');
// 獲取選中的 Option 元素集合 (HTMLCollection, 即時更新)
const selectedOptions = select.selectedOptions;
// 轉為數組並提取值/文本
const values = Array.from(selectedOptions).map(opt => opt.value); // ['2', '4']
const texts = Array.from(selectedOptions).map(opt => opt.text); // ['選項二', '選項四']
const objects = Array.from(selectedOptions).map(opt => ({ // 完整對象
value: opt.value,
text: opt.text,
index: opt.index
}));
console.log('值:', values.join(','));
console.log('文本:', texts.join(','));
console.log('對象:', objects);
優點:原生 API、無依賴、性能最優、返回即時集合、語義清晰。
兼容:IE8+ (需 polyfill `Array.from`),現代瀏覽器完美支持。
function getSelectedValues(select) {
const result = [];
const options = select.options; // HTMLOptionsCollection
for (let i = 0, len = options.length; i < len; i++) {
if (options[i].selected) {
result.push(options[i].value);
}
}
return result;
}
// 使用
const values = getSelectedValues(document.getElementById('multiSelect'));
原文即採用此傳統寫法,邏輯清晰但需手動循環。
// 直接返回選中值數組 ['2', '4']
const values = $('#multiSelect').val();
// 獲取文本
const texts = $('#multiSelect option:selected').map(function() {
return $(this).text();
}).get(); // ['選項二', '選項四']
// 獲取完整對象
const objects = $('#multiSelect option:selected').map(function() {
return { value: this.value, text: this.text, index: this.index };
}).get();
注意:jQuery 3.0+ `
const form = document.querySelector('form'); // 或 select.closest('form')
const formData = new FormData(form);
// 獲取同名多值數組
const values = formData.getAll('items'); // ['2', '4']
// 直接發送 (自動處理多值)
fetch('/api/submit', { method: 'POST', body: formData });
優點:標準化、自動處理編碼、文件上傳、多值同名、無需手動拼接。
// 獲取顯示文本 (用戶可見內容)
const texts = Array.from(select.selectedOptions).map(o => o.textContent);
// 或
const texts = [...select.selectedOptions].map(o => o.label || o.textContent); // option.label 優先
// 原生
select.addEventListener('change', () => {
const values = Array.from(select.selectedOptions).map(o => o.value);
console.log('當前選中:', values);
// 觸發自定義事件或更新 UI
});
// jQuery
$('#multiSelect').on('change', function() {
const values = $(this).val();
console.log('當前選中:', values);
});
// 原生:設置值數組
function setSelectedValues(select, values) {
const valueSet = new Set(values);
for (const opt of select.options) {
opt.selected = valueSet.has(opt.value);
}
// 觸發 change 事件通知監聽器
select.dispatchEvent(new Event('change', { bubbles: true }));
}
// jQuery
$('#multiSelect').val(['1', '3', '5']).trigger('change');
| 坑點 | 現象 | 解決 |
|---|---|---|
未設置 multiple | 只能單選,.val() 返回字符串而非數組 | 必須添加 multiple 屬性 |
選項無 value | 返回選項文本而非預期值 | 始終為 <option value="..."> 顯式設置 value |
| 動態新增 option 後獲取失效 | 舊引用的 selectedOptions 未更新 | 每次獲取時現查 select.selectedOptions,勿緩存 |
IE < 11 不支持 selectedOptions | 報錯 undefined | 用 `options` 循環兼容,或引入 polyfill |
form.submit() 不觸發 JS 驗證 | 繞過 change 事件 | 用 `form.requestSubmit()` (現代) 或手動觸發驗證 |
// 基準測試概念
console.time('selectedOptions');
Array.from(select.selectedOptions).map(o => o.value);
console.timeEnd('selectedOptions'); // ~0.5ms
console.time('jQuery map');
$('#multiSelect option:selected').map(...).get();
console.timeEnd('jQuery map'); // ~2-3ms (選擇器解析開銷)
console.time('loop options');
for (let i=0;i
結論:原生 `selectedOptions` + `Array.from` 最快且語義最清晰。
| 場景 | 推薦方法 | 理由 |
|---|---|---|
| 現代項目、獲取值數組 | Array.from(select.selectedOptions).map(o=>o.value) | 原生、快、標準、鏈式操作 |
| 需兼容 IE8-10 | 循環 select.options | 無 polyfill 依賴 |
| jQuery 專案、簡潔優先 | $('#sel').val() | 一行代碼、自動轉數組 |
| 表單提交 | new FormData(form).getAll('name') | 標準化、自動編碼、支持文件 |
| 需獲取文本/索引/完整對象 | Array.from(selectedOptions).map(...) | 靈活提取任意屬性 |
| 程序化設置選中 | select.value = [] / $(sel).val(arr) | 標準 API、自動觸發 change |
掌握 selectedOptions 這一現代原生 API,能以最小成本解決 95% 的多選下拉框取值需求,代碼更簡潔、性能更優、維護性更強。