Ajax.Request [prototype.js]
非同期通信を行なう。
書式:new Ajax.Request(url[, options])
urlには、CGI, PHPなどのサーバサイドプログラム名やXMLやJSONなどのファイル名を指定する。
Option | Default | 説明 |
asynchronous | true | XMLHttpRequestを使った非同期通信を行なうかどうかを設定する。デフォルトは非同期通信を行なう(true)。 |
method | post | get, post, put, propfind |
parameters | ” | ‘get’メソッド用パラメータ。URLエンコーディング必要。(例) “name=” + userNmae + “&age=” + userAge |
postBody | None | ‘post’メソッド用の送信データ(request body)。URLエンコーディング必要。postBodyを空にすると、parametersで設定された値を送信する。 |
コールバック | 説明 |
onCreate(ver 1.5.1) | Ajax.Requestオブジェクトが初期化されたときの処理 | onSuccess | 通信が成功した時の処理 |
onFilure> | 通信が失敗した時の処理 |
onComplete | 通信が完了した時の処理(通信が成功しても失敗してもこの処理が行なわれる) |
onException | 例外が発生した時の処理 |
[サンプル]
Ajax.Requestの例
JavaScript
function getData(key) { new Ajax.Request( "getData.php", { method: "get", parameters: "key=" + key, onComplete: showRes } ); } function showRes(request) { alert(request.responseText); }