Request Specifically made for receiving HTML.
Extends:
Syntax:
var myHTMLRequest = new Request.HTML([options]);
Arguments:
- options - (object, optional) See options below. Also inherited are all the options from Request.
Options:
- evalScripts - (boolean: defaults to true) If set to true,
script
tags inside the response will be evaluated. This overrides thefalse
default from Request. - update - (element: defaults to null) The Element to insert the response text of the Request into upon completion of the request.
- append - (element: defaults to null) The Element to append the response text of the Request into upon completion of the request.
- filter - (mixed: defaults to null) To filter the response tree by a selector or function. See Elements:filter
Events:
success
- (function) Function to execute when the HTML request completes. This overrides the signature of the Request success event.
Signature:
onSuccess(responseTree, responseElements, responseHTML, responseJavaScript)
Arguments:
- responseTree - (element) The node list of the remote response.
- responseElements - (array) An array containing all elements of the remote response.
- responseHTML - (string) The content of the remote response.
- responseJavaScript - (string) The portion of JavaScript from the remote response.
Returns:
- (object) A new Request.HTML instance.
Examples:
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'));
See Also:
Setter
Sets a default Request.HTML instance for an Element.
Syntax:
el.set('load'[, options]);
Arguments:
- options - (object) The Request options.
Returns:
- (element) The target Element.
Example:
el.set('load', {evalScripts: true});
el.load('some/request/uri');
Getter
Returns either the previously set Request.HTML instance or a new one with default options.
Syntax:
el.get('load');
Arguments:
- property - (string) the Request.HTML property argument.
Returns:
- (object) The Request instance.
Example:
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');
Custom Type to allow all of its methods to be used with any DOM element via the dollar function $.
Updates the content of the Element with a Request.HTML GET request.
Syntax:
myElement.load(url);
Arguments:
- url - (string) The URL pointing to the server-side document.
Returns:
- (element) The target Element.
Example:
HTML
<div id="content">Loading content...</div>
JavaScript
$('content').load('page_1.html');