Class: Request.HTML

HTMLを受け取るよう指定されたRequestです。

継承:

Request

構文:

var myHTMLRequest = new Request.HTML([options]);

引数:

  1. options - (オブジェクト, オプション) 以下のオプションを参考のこと。Requestからすべてのオプションを継承します。

オプション:

  • update - (要素: 初期値=null) リクエスト完了時にリクエストのレスポンステクストを挿入したい要素。

イベント:

success

  • (関数) HTMLリクエストが完了したときに実行する関数。これはRequestのsuccessイベントを上書きします。
表記:
onSuccess(responseTree, responseElements, responseHTML, responseJavaScript)
引数:
  1. responseTree - (要素) リモートレスポンスのノードリスト。
  2. responseElements - (配列) リモートレスポンスの全要素を含む配列。
  3. responseHTML - (文字列) リモートレスポンスの中身。
  4. responseJavaScript - (文字列) リモートレスポンスの中のJavaScript部分。

戻り値:

  • (オブジェクト) 新しいRequest.HTMLインスタンス。

例:

単純なGETリクエスト:

var myHTMLRequest = new Request.HTML().get('myPage.html');

データを文字列にしたPOSTリクエスト:

var myHTMLRequest = new Request.HTML({url:'myPage.html'}).post("user_id=25&save=true");

データをオブジェクトにしてGETで渡す:

//"load/?user_id=25"を読み込み。
var myHTMLRequest = new Request.HTML({url:'load/'}).get({'user_id': 25});

要素をデータにしてPOSTで渡す:

HTML
<form action="save/" method="post" id="user-form">

    <p>
        Search: <input type="text" name="search" />
        Search in description: <input type="checkbox" name="search_description" value="yes" />

        <input type="submit" />
    </p>
</form>
JavaScript
//submitイベントか、フォームハンドラで実行。

var myHTMLRequest = new Request.HTML({url:'save/'}).post($('user-form'));

参考情報:

Request

Hash: Element.Properties

参考情報: Element.Properties

Elementプロパティ: load

Set

要素にデフォルトのRequest.HTMLインスタンスを設定します。

構文:

el.set('load'[, options]);

引数:

  1. options - (オブジェクト) リクエストオプション。

戻り値:

  • (要素) ターゲット要素。

例:

el.set('load', {evalScripts: true});
el.load('some/request/uri');

Get

以前にセットされたRequest.HTMLインスタンスを取得するか、デフォルトオプションから新しいインスタンスを生成します。

構文:

el.get('load', options);

引数:

  1. options - (オブジェクト, オプション) Request.HTMLオプションです。これが渡された場合、すでにインスタンスがあったかどうかに関わらず、新しいインスタンスが生成されます。

戻り値:

  • (オブジェクト) Requestインスタンス。

例:

el.set('load', {method: 'get'});
el.load('test.html');

//getはRequest.HTMLを返し、クラスのメソッドを使えるようにします。
el.get('load').post('http://localhost/script');

Native: Element

$関数によって取得したDOM要素がこれらのメソッドをすべて使えるようにします。

Elementメソッド: load

Request.HTMLのGETメソッドを使って、コンテンツを更新します。

構文:

myElement.load(url);

引数:

  1. url - (文字列) サーバサイドのファイルを指定するURLです。

戻り値:

  • (要素) ターゲットとなる要素。

例:

HTML
<div id="content">Loading content...</div>
JavaScript
$('content').load('page_1.html');

参考情報:

このドキュメントはMooToolsのドキュメントを元に高橋文樹が翻訳(ちょっと改変)しました。
本家と同じく、Attribution-NonCommercial-ShareAlike 3.0ライセンスで公表されています。

トップに戻る