基礎 DOM 結構
<select id="citySelect" class="form-select">
<option value="">請選擇城市</option>
<option value="bj">北京</option>
<option value="sh">上海</option>
<option value="gz">廣州</option>
<option value="sz">深圳</option>
</select>
核心操作速查表
1. 獲取值與文本
const $sel = $('#citySelect');
// 獲取選中值 (最常用)
const value = $sel.val(); // "bj"
// 獲取選中文本
const text = $sel.find('option:selected').text(); // "北京"
// 獲取選中索引
const index = $sel.prop('selectedIndex'); // 1
// 獲取所有選項
const options = $sel.find('option').map(function() {
return { value: this.value, text: $(this).text() };
}).get();
2. 設置選中狀態
// 按值設置 (推薦)
$sel.val('sh'); // 選中上海
// 按索引設置
$sel.prop('selectedIndex', 2);
// 按文本設置 (需遍歷)
$sel.find('option').filter(function() {
return $(this).text() === '廣州';
}).prop('selected', true);
3. 動態增刪選項
// 追加單個
$sel.append('');
// 批量追加 (性能優於循環 append)
const newOptions = ['杭州', '南京', '武漢'].map((city, i) =>
``
);
$sel.append(newOptions.join(''));
// 插入到首位 (作為提示項)
$sel.prepend('');
// 刪除最後一個
$sel.find('option:last').remove();
// 刪除指定值
$sel.find('option[value="gz"]').remove();
// 刪除指定索引
$sel.find('option').eq(1).remove();
// 清空所有 (保留首個提示項)
$sel.find('option:not(:first)').remove();
// 完全清空
$sel.empty();
4. 事件綁定
// 選中改變事件
$sel.on('change', function() {
console.log('選中值:', this.value);
console.log('選中文本:', $(this).find('option:selected').text());
});
// 獲取原生事件對象
$sel.on('change', function(e) {
console.log(e.target.value); // 原生 DOM 值
});
進階場景:二級/三級聯動
// 數據結構
const regionData = {
'bj': [{v:'dq',t:'東城'},{v:'xc',t:'西城'}],
'sh': [{v:'hp',t:'黃浦'},{v:'xh',t:'徐匯'}],
// ...
};
// 省份變化觸發城市更新
$('#provinceSelect').on('change', function() {
const province = this.value;
const $city = $('#citySelect');
// 清空並添加提示項
$city.empty().append('');
if (province && regionData[province]) {
const options = regionData[province].map(c =>
``
).join('');
$city.append(options).prop('disabled', false);
} else {
$city.prop('disabled', true);
}
}).trigger('change'); // 初始化觸發
遠程數據加載 (AJAX)
async function loadCities(provinceCode) {
const $city = $('#citySelect').empty().append('').prop('disabled', true);
try {
const response = await fetch(`/api/cities?province=${provinceCode}`);
const cities = await response.json();
$city.empty().append('');
cities.forEach(c => $city.append(``));
$city.prop('disabled', false);
} catch (err) {
$city.empty().append('');
console.error(err);
}
}
$('#provinceSelect').on('change', function() {
if (this.value) loadCities(this.value);
});
表單驗證集成
// jQuery Validate 插件規則
$('#form').validate({
rules: {
citySelect: { required: true } // 必須選擇非空值
},
messages: {
citySelect: { required: '請選擇城市' }
}
});
// 原生 HTML5 驗證
性能優化建議
- 大量選項 (>500) 使用 Select2、Choices.js、Tom Select 等虛擬滾動組件
- 批量操作用字符串拼接或
DocumentFragment 替代循環 append
- 避免在
change 事件中觸發同步 AJAX,導致 UI 卡頓
- 銷毀組件時
$sel.off().empty() 防止內存洩漏