DIV CSS 佈局教程網

jQuery 操作下拉選單:取得與設定 select 選項的完整語法整理
編輯:JQuery特效代碼     

Select 的讀寫看似簡單,卻是 DOM 操作裡最容易出錯的一環——因為它同時有「值」、「顯示文字」、「索引」三種狀態,而設定方式又隨版本與情境而異。以下把常用語法一次整理齊全。

取得 select 的目前狀態

取得選中項的顯示文字:

$("#ddlRegType").find("option:selected").text();

取得選中項的 value:

$("#ddlRegType").val();

取得選中項的索引:

$("#ddlRegType").get(0).selectedIndex;

這三個是最常用的組合。.val() 是最簡潔的取值方式,不必繞 option:selected;只有在需要文字或索引時,才需要明確選到 option。

設定 select

依索引設定:

$("#ddlRegType").get(0).selectedIndex = index;   // index 為索引值

依 value 設定(三種寫法,推薦第一種):

$("#ddlRegType").val("Normal");
$("#ddlRegType").attr("value", "Normal");
$("#ddlRegType").get(0).value = value;

.val() 是首選:語意明確、可鏈式呼叫、且對多選 select 能傳入陣列一次選多項。第二種 attr("value", ...) 設的是 select 元素自身的 value 屬性,行為不如預期可靠,不建議使用。

依顯示文字設定(jQuery 沒有直接 API,需自行比對):

var count = $("#ddlRegType option").length;
for (var i = 0; i < count; i++) {
    if ($("#ddlRegType").get(0).options[i].text == text) {
        $("#ddlRegType").get(0).options[i].selected = true;
        break;
    }
}

用 jQuery 寫可以更簡潔:

$("#ddlRegType option").filter(function () {
    return $(this).text() === text;
}).prop("selected", true);

清空 select

$("#ddlRegType").empty();

這會移除所有 option。若你只是想「取消所有勾選、保留選項」,應該改用:

$("#ddlRegType").val("");
// 或
$("#ddlRegType option").prop("selected", false);

動態增刪選項

新增:

$("#ddlRegType").append('<option value="3">其他</option>');

移除指定項:

$("#ddlRegType option[value='3']").remove();

從 Ajax 回傳的陣列批次填充,是實務上最常見的場景:

$.getJSON("api/types", function (list) {
    var $sel = $("#ddlRegType").empty();
    $.each(list, function (i, item) {
        $sel.append($('<option>', { value: item.id, text: item.name }));
    });
});

用 $('<option>', {...}) 的第二個參數設定屬性,比手拼 HTML 字串安全——它會自動處理 HTML 轉義,選項名稱裡含引號或角括號時不會破版,也不會成為 XSS 的入口。

幾個實務地雷

  • 設定後記得觸發 change。用程式改值不會自動觸發 change 事件,若有其他邏輯掛在那上面,需要手動補上 $("#ddlRegType").trigger("change")。
  • 選中屬性用 prop 而非 attr。selected 與 checked 一樣,是會變化的狀態。jQuery 1.6 之後請一律用 prop("selected", true)。
  • 找不到對應值時的行為。.val("不存在的值") 不會報錯,而是讓 select 變成「無任何選項被選中」,.val() 隨後回傳 null。後端若假設必有值,容易在這裡出問題。
  • 多選 select 的讀寫。讀:$("#sel").val() 回傳陣列。寫:$("#sel").val([1, 3])。記得 HTML 上要加 multiple 屬性。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved