jQuery ajax()メソッド

jQuery AJAX 方法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 方法jQuery AJAX メソッド

その他の拡張