ajaxStop( handler() )

jQuery API の ajaxStop( handler() ) は、全てのAjaxリクエストが完了した時に呼び出すグローバルAjaxイベントハンドラを登録するメソッド。

引数

handler()

全てのAjaxリクエストが完了した時に実行するコールバック関数。

記述方法

jQuery( セレクター ) . ajaxStop( function() {
    jQuery( this ) . text( 'Ajaxリクエスト完了' );
} );

全てのAjaxリクエストが完了した時に、セレクターに指定した要素内に、「Ajaxリクエスト完了」と表示する。

記述例

jQuery( '#sample' ) . ajaxStop( function() {
    jQuery( this ) . text( 'Ajaxリクエスト完了' );
} );

全てのAjaxリクエストが完了した時に、idが「sample」の要素内に、「Ajaxリクエスト完了」と表示する。

実装例(サンプル)

実装例(サンプル)の動作について

「toggle」ボタンをクリックすると、「jquery-sample-get.php」ファイルの実行結果を読み込み、黄色のボックス要素内に表示する。リクエスト時、「year」「month」「day」のパラメータを送信し、「jquery-sample-get.php」ファイルで取得し、表示する。

Ajaxリクエストが完了すると、読み込んだデータの下に、赤色の水平線と「Ajaxリクエスト完了」を追加する。「toggle」ボタンの右横にも「Ajaxリクエスト完了」と表示する。

「toggle」ボタンを、再度クリックすると、元に戻す。

実装例(サンプル)のソースコード

JavaScript

<script>
<!--
jQuery( function() {
    jQuery( '#jquery-sample-message' ) . ajaxStop( function() {
        jQuery( '#jquery-sample-message' ) . text( 'Ajaxリクエスト完了' );
        jQuery( '#jquery-sample-get' ) . append( '<hr /><p>Ajaxリクエスト完了</p>' );
    } );
    jQuery( '#jquery-sample-button' ) . toggle(
        function() {
            jQuery . get(
                'jquery-sample-get.php',
                { year: '2011', month: '12', day: '7' },
                function( data ) {
                    jQuery( '#jquery-sample-get' ) . append( data );
                }
                ,'html'
            );
        },
        function() {
            jQuery( '#jquery-sample-get' ) . html( '' );
            jQuery( '#jquery-sample-message' ) . text( '' );
        }
    );
} );
// -->
</script>

CSS

<style type="text/css">
<!--
#jquery-sample {
    margin: 10px;
}
#jquery-sample-get {
    margin: 10px;
    padding: 10px;
    height: 140px;
    background-color: yellow;
    border: 1px solid gray;
    border-radius: 10px;
}
#jquery-sample-get hr {
    height: 1px;
    background-color: red;
}
-->
</style>

HTML

<div id="jquery-sample">
    <p>
        <button id="jquery-sample-button">toggle</button>
        <span id="jquery-sample-message"></span>
    </p>
    <div id="jquery-sample-get"></div>
</div>

読み込むPHPファイル

<p>読み込んだ内容。</p>
<p>年:<?php echo  $_GET['year']; ?>年</p>
<p>月:<?php echo  $_GET['month']; ?>月</p>
<p>日:<?php echo  $_GET['day']; ?>日</p>

スポンサード リンク

カテゴリー: Ajax, API, JavaScript, jQuery, グローバルAjaxイベントハンドラ タグ: パーマリンク