Request/HTML

Class: Request.HTML

接收HTML的请求。

语法:

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

参数:

1. options - (object, optional) 请参见下面的选项。所有选项继承自Requst。

选项:

• evalScripts - (boolean: defaults to true) 如果设置为true,响应里script内的内容将被执行。
• update - (element: defaults to null) 请求完成后响应文本插入元素。
• append - (element: defaults to null) 请求完成后响应文本追加到元素。。
• filter - (mixed: defaults to null) 用一个选择器或一个函数过滤响应.

事件:

success

• (function) HTML请求成功时执行,它重写了Request success事件。

Signature:

onSuccess(responseTree, responseElements, responseHTML, responseJavaScript)

参数:

1. responseTree - (element) 远程响应的节点列表。
2. responseElements - (array) 包含远程响应中的所有元素的数组。
3. responseHTML - (string) 远程响应的内容。
4. responseJavaScript - (string) 远程响应部分的JavaScript。

返回:

• (object) 一个新的Request.HTML实例。

示例:

Simple GET Request:

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

POST Request with data as String:

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

Data from Object Passed via GET:

//Loads "load/?user_id=25".
var myHTMLRequest = new Request.HTML({url: 'load/'}).get({'user_id': 25});

Data from Element via 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

//Needs to be in a submit event or the form handler.
var myHTMLRequest = new Request.HTML({url: 'save/'}).post($('user-form'));

Object: Element.Properties

Element Property: load

Setter

为一个元素设置默认Request.HTML实例。

语法:

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

参数:

1. options - (object) 请求选项。

返回:

• (element) 目标元素。

例如:

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

Getter

返回前一个设置的Request.HTML或一个新的Request.HTML实例.

语法:

el.get('load');

参数:

1. property - (string) Request.HTML属性参数。

返回:

• (object) 请求实例。

例如:

el.set('load', {method: 'get'});
el.load('test.html');
// the getter returns the Request.HTML instance, making its class methods available.
el.get('load').post('http://localhost/script');

Type: Element

自定义类型，其所有的方法允许通$函数生成的DOM元素使用。

Element Method: load

更新元素的内容,使用一个Request.HTML GET请求。

语法:

myElement.load(url);

参数:

1. url - (string) 请求的URL。

返回:

• (element)目标元素。

例如:

HTML

<div id="content">Loading content...</div>

JavaScript

$('content').load('page_1.html');