jQuery ajax()メソッド
例
AJAX リクエストを使用して <div> 要素のテキストを変更する:
$("button").click(function(){
$.ajax({url:"demo_test.txt",success:function(result){
$("#div1").html(result);
}});
});
試してみる »
定義と使い方
ajax() メソッドは、AJAX(非同期 HTTP)リクエストを実行するために使用されます。
すべての jQuery AJAX メソッドは ajax() メソッドを使用します。このメソッドは通常、他のメソッドでは実行できないリクエストに使用されます。
構文
$.ajax({name:value, name:value, ... })
このパラメータは、AJAX リクエストの1つ以上の名前/値のペアを指定します。
以下の表に、可能な名前/値を示します:
| 名前 | 値/説明 |
|---|---|
| async | リクエストを非同期で処理するかどうかを示すブール値。デフォルトは true です。 |
| beforeSend(xhr) | リクエストを送信する前に実行される関数。 |
| 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 オブジェクトを作成するための関数。 |
その他の例
非同期 AJAX リクエストを生成する
非同期設定を使用して非同期リクエストを指定する方法。
指定したデータ型を持つ AJAX リクエストを生成する
dataType 設定を使用してリクエストのデータ型を指定する方法。
エラーを含む AJAX リクエストを生成する
error 設定を使用して AJAX リクエストのエラーを処理する方法。
その他の拡張
jQuery AJAX メソッド