ajaxStart(handler)


version 1.0 以降

解説

アクティブなAjaxリクエストがない場合に、通信前に実行するコールバック関数を登録します。

全てのAjaxイベントの前に実行されます。アクティブなリクエストが存在する場合は実行されません。 共通の通信前の処理を登録する場合に使用します。

引数

  • callback : 通信前に実行されるコールバック関数。

戻り値

  • jQueryオブジェクト

例1:通信前に、その旨を表示します。

$(function(){ // DOM準備完了
    // 通信前に実行するコールバック関数を登録
    $("#test_result").ajaxStart(function(){
        $(this).append($("<p>----- ajaxStart: 通信を開始します -----</p>"));
    });
});

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

$.get(
    "test_get.php",                 // 送信先
    null,
    function(data, status) {        // 通信成功時にデータを表示
        $("#test_result")
            .append($("<p/>")
                .append("----- 通信成功 -----").append("<br/>")
                .append("status: ").append(status).append("<br/>")
                .append("data: ").append(data)
            );
    },
    "html"                          // 応答データ形式
);