萬盛學電腦網

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

jQuery AJAX 載入後端資料綁定 DropDownList (下拉選單) 完整範例

前端實作 (jQuery + ASP.NET MVC / Web API)

$(document).ready(function() {
    loadSchools();
});

function loadSchools() {
    var url = '@Url.Action("GetSchools")'; // Razor 語法產生 /Controller/GetSchools
    // 純前端專案請寫死 API 路徑:var url = '/api/schools';

    $.ajax({
        url: url,
        type: 'GET',
        dataType: 'json',
        cache: false, // 避免 IE 快取 GET 請求
        success: function(data) {
            // data 格式假設: [{SchoolId: 1, SchoolName: '某大學'}, ...]
            var $ddl = $('#SchoolId');
            $ddl.empty(); // 清空現有選項

            // 選項 1: 加入預設提示項
            $ddl.append($('

後端範例 (ASP.NET MVC Controller)

public class SchoolController : Controller {
    public JsonResult GetSchools() {
        var schools = _schoolService.GetAll(); // List
        // 匿名類型投影,避免循環引用、過度暴露欄位
        var data = schools.Select(s => new { SchoolId = s.Id, SchoolName = s.Name });
        return Json(data, JsonRequestBehavior.AllowGet); // MVC 5 需允許 GET
    }
}

核心細節解析

細節說明
dataType: 'json'jQuery 自動解析回應為 JS 物件陣列,要求回應 Content-Type: application/json。
cache: falseGET 請求 IE 會強力快取,加此參數自動加時間戳 _=timestamp。
$ddl.empty()清空舊選項,避免重複疊加。
$('<option>', {value, text})jQuery 建立元素語法,自動編碼屬性值,防 XSS。
錯誤處理error 回調捕獲網路/HTTP 錯誤,給使用者回饋。
依賴下拉選單若有「縣市→鄉鎮」級聯,在 success 中綁定 change 事件觸發下一級載入。

進階:Select2 / Chosen 美化與搜尋

// 初始化 Select2 (需引入 CSS/JS)
$('#SchoolId').select2({
    placeholder: '請選擇或搜尋學校',
    allowClear: true,
    width: '100%'
});

// AJAX 載入後重新初始化 (若 Select2 已綁定)
$('#SchoolId').select2('destroy').select2({...}).empty().append(...).trigger('change');

現代 Fetch API 寫法 (無 jQuery 依賴)

async function loadSchools() {
    try {
        const resp = await fetch('/api/schools', { credentials: 'include' });
        if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
        const data = await resp.json();

        const ddl = document.getElementById('SchoolId');
        ddl.innerHTML = '';
        data.forEach(school => {
            const opt = document.createElement('option');
            opt.value = school.SchoolId;
            opt.textContent = school.SchoolName;
            ddl.appendChild(opt);
        });
    } catch (err) {
        console.error(err);
        // UI 錯誤提示
    }
}
document.addEventListener('DOMContentLoaded', loadSchools);

總結

jQuery AJAX 綁定 DropDownList 核心流程:$.ajax → success → empty() → each append option。關鍵在編碼一致 (UTF-8)、快取控制、錯誤處理、XSS 防護。現代專案可直接使用 fetch + 原生 DOM 操作,減少依賴。

copyright © 萬盛學電腦網 all rights reserved