[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