load(url, [data], [handler])

解説

HTTPリクエストを使用してデータを取得し、DOM要素を置き換えます。 jQueryセレクタを指定することができ、応答データから、jQueryセレクタによる走査結果を取得することができます。

DOM要素を置き換えるのは、通信が成功した場合のみです。 （statusが"success"もしくは"notmodified"の場合）

引数

• url ： リクエスト先のURL。スペースに続けて、jQueryセレクタを指定可能。
• [data] ： サーバに送信するパラメータ。キーと値のペア(ハッシュ)。（オプション）
• [callback] ： 通信が完了したときに実行されるコールバック関数。（オプション）
  このコールバック関数には 3つの引数が渡されます。
  

  引数	説明
  responseText	取得したデータ
  status	リクエスト結果を表す文字列。 参照：jQuery.ajax(settings)#status
  XMLHttpRequest	XMLHttpRequestオブジェクト

戻り値

• jQueryオブジェクト

例

例1:サーバ上にある test_get.php を取得し、その内容でテスト結果領域を置換します。 通信完了後、取得したデータ、リクエスト結果、XMLHttpRequestオブジェクトを表示します。

test_get.php

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

$("#test_result .disp").load(
    "test_get.php",                                     // 送信先
    null,
    function(responseText, status, XMLHttpRequest) {
        // 通信完了後に実行されるコールバック関数
        alert("[ 通信完了！]\n" 
            + "--- responseText ---\n"   + responseText + "\n"
            + "--- status ---\n"         + status       + "\n"
            + "--- XMLHttpRequest ---\n" + XMLHttpRequest
        );
    });

ページトップヘ

ページトップヘ