request.html.md.svn-base

一款开源强大的javascript控件

[Request]: /Request/Request

Class: Request.HTML {#Request-HTML}
===================================

专门用于响应内容为HTML的请求

### 继承:

[Request][]

### 语法:

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

### 参数:

1. options - (*object*, 可选) 参见[Request][]的可选项, 以及下列可选项:

### 可选项:

* update       - (*element*: 默认为 null) 请求响应的responseText要插入的目标元素
* evalScripts  - (*boolean*: 默认为 true) 如果为true, 则响应内容中`script`标签中的脚本内容将被执行
* evalResponse - (*boolean*: 默认为 false) 如果为true, 则整个响应内容将被作为脚本来执行

### 事件:

#### complete

* (*function*) 请求完成时触发

##### 标识:

	onComplete(responseTree, responseElements, responseHTML, responseJavaScript)

##### 参数:

1. responseTree 	  - (*element*) 响应内容中的HTML节点树
2. responseElements   - (*array*)   响应内容中所有元素
3. responseHTML		  - (*string*)  响应内容(HTML文本)
4. responseJavaScript - (*string*)  响应内容中所包含的Javascript代码文本

### 返回值:

* (*object*) 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
	
	$('mySubmitBtn').addEvent('click', function(){
		var myHTMLRequest = new Request.HTML({url:'save/'}).post($('user-form'));	
	});


### 另参考:

[Request][]


Hash: Element.Properties {#Element-Properties}
==============================================

参见[Element.Properties](/Element/Element/#Element-Properties)

Element 属性: load {#Element-Properties:load}
-------------------------------------------------

### 设置

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

#### 语法:

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

#### 参数:

1. options - (*object*) Request可选项

#### 返回值:

* (*element*) 主调元素

#### 示例:

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


### 获取

获取元素上之前设置的Request.HTML实例(或者使用默认可选项创建的新实例))

#### 语法:

	el.get('load', options);

#### 参数:

1. options - (*object, 可选) Request.HTML可选项. 如果给出了该项, 则将总是返回一个根据给出的可选项创建的Request.HTML新实例

#### 返回值:

* (*object*) Request.HTML实例

#### 示例:

	el.set('load', {method: 'get'});
	el.load('test.html');
	el.get('load').post('http://localhost/script');



Native: Element {#Element}
==========================

Element 方法: load {#Element: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');



### 另参考:

[$]: /Element/Element/#dollar
[Request]: /Request/Request