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 オブジェクトを作成するために使用する関数 |
同期 AJAX リクエストをする
同期リクエストを指定するため、async の設定を使用する方法。
指定のデータタイプで AJAX リクエストを行う
リクエストのデータタイプを指定するため、dataType 設定を使用する方法。
エラー付きのAJAXリクエストをする
AJAX リクエストでのエラーに対処するため、error 設定を使用する方法。