ajaxSuccess(handler)


version 1.0 以降

解説

Ajaxリクエストが成功した時に実行するコールバック関数を登録します。

globalオプションがtrueの場合に、ローカルAjaxイベントのsuccessコールバック関数が実行された後に実行されます。 共通の通信成功時の処理を登録する場合に使用します。

引数

  • callback : リクエストが成功した時に実行されるコールバック関数。
    このコールバック関数には 3つの引数が渡されます。
    引数 説明
    event イベントオブジェクト
    参照:イベントオブジェクト
    XMLHttpRequest XMLHttpRequestオブジェクト
    options Ajax通信オプション

戻り値

  • jQueryオブジェクト

例1:サーバ上にある test_get.php を取得し、内容を表示します。 通信が成功した旨のメッセージを表示します。

test_get.php
<p>このデータは、サーバ上にあります。</p>

$(function(){ // DOM準備完了
    // Ajax通信成功時のコールバック関数を登録
    $("#test_result").ajaxSuccess(function(event, XMLHttpRequest, options){
        $(this).append("<p>----- ajaxComplete: 通信が成功しました -----</p>");
    });
});

$.get("test_get.php", null, function(data, status){
    $("#test_result").append(data);
});