jQuery ajax() メソッド

❮ jQuery AJAX メソッド

AJAX を使用し <div> のテキストを変更する:

$("button").click(function(){
    $.ajax({url: "demo_test.txt", success: function(result){
        $("#div1").html(result);
    }});
});
Try it Yourself »

定義と用法

ajax() メソッドは、AJAX(非同期 HTTP)リクエストを実行するために使用します。

全ての jQuery AJAX メソッドは、ajax() メソッドを使用します。 このメソッドは、主に、他のメソッドが使用できないリクエストに使用します。


構文

$.ajax({name:value, name:value, ... })

パラメータは、AJAX リクエスト用に 1 つ以上の名前/値のペアを指定する。

指定可能な名前/値は、下表の通り:

名前 値/説明
async リクエストを非同期に処理するかどうかを指定するブール値。デフォルトは true
beforeSend(xhr) リクエストを送信する前に実行する関数t
cache ブラウザに、リクエストしたページをキャッシュさせるかどうかを指定するブール値。デフォルトは true
complete(xhr,status) リクエストが終了したときに(success および error 関数の後で)実行する関数
contentType サーバへ送信するデータのコンテンツタイプ。デフォルトは、"application/x-www-form-urlencoded"
context コールバック関数に関した全 AJAX に対する "this" の値を指定する
data サーバに送信するデータを指定する
dataFilter(data,type) XMLHttpRequest の生の応答データを処理するために使用する関数
dataType サーバからの応答で期待するるデータ・タイプ
error(xhr,status,error) リクエスト失敗したときに実行する関数
global グローバル AJAX イベントハンドラを実行するかどうかを指定するブール値。デフォルトは true
ifModified レスポンスが最後のリクエスト以降に変更された場合にのみ、リクエストが成功したとみなすかどうかを指定するブール値。 デフォルトは false.
jsonp jsonp リクエストのコールバック関数をオーバーライドする文字列
jsonpCallback jsonp リクエストに対するコールバック関数名を指定する
password HTTP アクセス認証リクエストに使用するパスワードを指定する
processData リクエストにより送信されたデータを、クエリ文字列に変換するか否かを指定するブール値。デフォルトは true
scriptCharset リクエストの文字セットを指定する
success(result,status,xhr) リクエストが成功したときに実行する関数
timeout リクエストのタイムアウト(ミリ秒で)
traditional パラメータのシリアライズに古いスタイルを使用するかどうかを指定するブール値
type リクエストのタイプを指定する(GET または POST)
url リクエストを送信するための URL を指定する。デフォルトは現在のページ
username HTTP アクセス認証リクエストで使用するユーザ名を指定
xhr XMLHttpRequest オブジェクトを作成するために使用する関数

Try it Yourself - 例

同期 AJAX リクエストをする
同期リクエストを指定するため、async の設定を使用する方法。

指定のデータタイプで AJAX リクエストを行う
リクエストのデータタイプを指定するため、dataType 設定を使用する方法。

エラー付きのAJAXリクエストをする
AJAX リクエストでのエラーに対処するため、error 設定を使用する方法。


❮ jQuery AJAX メソッド