萬盛學電腦網

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

jQuery AJAX 載入文字內容完整教學:同步與非同步模式

使用 jQuery 的 $.ajax() 載入外部文字檔案是前端開發常見需求。本文以 W3School 經典範例為基礎,詳細說明同步/非同步模式差異、編碼處理、錯誤處理等實務細節。

基礎範例:同步載入(教學用)

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script>
$(document).ready(function() {
    $("button").click(function() {
        // 同步請求:async: false(已棄用,僅教學示範)
        var htmlObj = $.ajax({
            url: "ab.txt",
            async: false
        });
        $("#myDiv").html(htmlObj.responseText);
    });
});
</script>
</head>
<body>
<div id="myDiv"><h2>hello world</h2></div>
<button>載入內容 (jQuery AJAX)</button>
</body>
</html>

重要觀念釐清

⚠️ 同步請求 (async: false) 已棄用

  • 會凍結瀏覽器主執行緒,導致頁面無回應
  • 現代瀏覽器主執行緒同步請求會拋出警告
  • 生產環境嚴禁使用

✅ 推薦:非同步請求搭配 Promise/async-await

// 現代寫法(jQuery 3.0+)
$("#loadBtn").click(async function() {
    try {
        const response = await $.ajax({
            url: "ab.txt",
            dataType: "text", // 明確指定回應類型
            cache: false      // 避免快取問題
        });
        $("#myDiv").html(response);
    } catch (error) {
        console.error("載入失敗:", error);
        $("#myDiv").html("<p style='color:red'>載入失敗,請稍後再試</p>");
    }
});

編碼問題完整解決方案

中文亂碼通常源於伺服器回應缺少或錯誤的 Content-Type 標頭。解決辦法:

  1. 伺服器端設定(最根本):
    // PHP 範例
    header("Content-Type: text/plain; charset=utf-8");
  2. 前端強制指定:
    $.ajax({
        url: "ab.txt",
        beforeSend: function(xhr) {
            xhr.overrideMimeType("text/plain; charset=utf-8");
        }
    });
  3. 檔案儲存為 UTF-8 無 BOM:避免 BOM 字元干擾

進階應用模式

載入狀態指示器

$("#loadBtn").click(function() {
    var $btn = $(this).prop("disabled", true).text("載入中...");
    $("#myDiv").html("<div class='loading'>載入中...</div>");

    $.ajax({
        url: "ab.txt",
        dataType: "text"
    })
    .done(function(data) {
        $("#myDiv").html(data);
    })
    .fail(function() {
        $("#myDiv").html("<p class='error'>載入失敗</p>");
    })
    .always(function() {
        $btn.prop("disabled", false).text("重新載入");
    });
});

快取控制策略

// 方法一:時間戳參數
$.ajax({
    url: "ab.txt?" + Date.now(),
    cache: false // jQuery 內建快取控制
});

// 方法二:HTTP 標頭控制(需伺服器配合)
// Cache-Control: no-cache, must-revalidate

錯誤處理最佳實務

$.ajax({
    url: "ab.txt",
    dataType: "text",
    timeout: 5000, // 5 秒逾時
    error: function(xhr, status, error) {
        var msg = status === "timeout" ? "請求逾時" :
                  xhr.status === 404 ? "找不到檔案" :
                  "伺服器錯誤 (" + xhr.status + ")";
        $("#myDiv").html("<p class='error'>" + msg + "</p>");
    }
});

總結

雖然同步 AJAX 寫法簡單,但現代 Web 開發必須採用非同步模式。配合 async/await 語法,程式碼既清晰又能提供良好使用者體驗。記住處理編碼、錯誤、快取三大關鍵點,才能建立穩健的資料載入功能。

copyright © 萬盛學電腦網 all rights reserved