Request Specifically made for receiving HTML.

Request

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

1. options - (object, optional) See options below. Also inherited are all the options from Request.

• evalScripts - (boolean: defaults to true) If set to true, script tags inside the response will be evaluated. This overrides the false 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

• (function) Function to execute when the HTML request completes. This overrides the signature of the Request success event.

onSuccess(responseTree, responseElements, responseHTML, responseJavaScript)

1. responseTree - (element) The node list of the remote response.
2. responseElements - (array) An array containing all elements of the remote response.
3. responseHTML - (string) The content of the remote response.
4. responseJavaScript - (string) The portion of JavaScript from the remote response.

• (object) A new Request.HTML instance.

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

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

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

<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>

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

Request

see Element.Properties

Sets a default Request.HTML instance for an Element.

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

1. options - (object) The Request options.

• (element) The target Element.

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

Returns either the previously set Request.HTML instance or a new one with default options.

el.get('load');

1. property - (string) the Request.HTML property argument.

• (object) The Request instance.

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.

myElement.load(url);

1. url - (string) The URL pointing to the server-side document.

• (element) The target Element.

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

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

The Request.HTML class will (by default) add a custom header that, if used for a cross-origin request, will have to be reported as allowed in the preflight request, in addition to any other headers you may set yourself:

Access-Control-Allow-Headers: X-Requested-With

• $, Request