Version 3.18.1
Show:

PjaxContent Class

Module: pjax-content
Parent Module: pjax

Available since 3.7.0

Y.Router extension that provides the content fetching and handling needed to implement the standard pjax (HTMP5 pushState + Ajax) functionality.

This makes it easy to fetch server rendered content for URLs using Ajax. By helping the router to fulfill the "request" for the content you can avoid full page loads.

The PjaxContent class isn't useful on its own, but can be mixed into a Router-based class along with the PjaxBase class to add Pjax functionality to that Router. For a pre-made standalone Pjax router, see the Pjax class.

var MyRouter = Y.Base.create('myRouter', Y.Router, [
                Y.PjaxBase,
                Y.PjaxContent
            ], {
                // ...
            });

Methods

_onPjaxIOComplete

(
  • id
  • ioResponse
  • details
)
protected

Defined in pjax/js/pjax-content.js:159

Available since 3.7.0

Handles IO complete events.

This parses the content from the Y.io() response and puts it on the route's response object.

Parameters:

  • id String

    The Y.io transaction id.

  • ioResponse Object

    The Y.io response object.

  • details Object

    Extra details carried through from loadContent().

_onPjaxIOEnd

(
  • id
  • details
)
protected

Defined in pjax/js/pjax-content.js:189

Available since 3.5.0

Handles IO end events.

Parameters:

  • id String

    The Y.io transaction id.

  • details Object

    Extra details carried through from loadContent().

getContent

(
  • responseText
)
Object

Defined in pjax/js/pjax-content.js:38

Available since 3.5.0

Extracts and returns the relevant HTML content from an Ajax response. The content is extracted using the contentSelector attribute as a CSS selector. If contentSelector is null, the entire response will be returned.

The return value is an object containing two properties:

  • node: A Y.Node instance for a document fragment containing the extracted HTML content.

  • title: The title of the HTML page, if any, extracted using the titleSelector attribute (which defaults to looking for a <title> element). If titleSelector is not set or if a title could not be found, this property will be undefined.

Parameters:

  • responseText String

    Raw Ajax response text.

Returns:

Object:

Content object with the properties described above.

loadContent

(
  • req
  • res
  • next
)

Defined in pjax/js/pjax-content.js:83

Available since 3.7.0

Pjax route middleware to load content from a server. This makes an Ajax request for the requested URL, parses the returned content and puts it on the route's response object.

This is route middleware and not intended to be the final callback for a route. This will add the following information to the route's request and response objects:

  • req.ioURL: The full URL that was used to make the Y.io() XHR. This may contain "pjax=1" if the addPjaxParam option is set.

  • res.content: An object containing node and title properties for the content extracted from the server's response. See getContent() for more details.

  • res.ioResponse: The full Y.io() response object. This is useful if you need access to the XHR's response status or HTTP headers.

Parameters:

  • req Object

    Request object.

  • res Object

    Response Object.

  • next Function

    Function to pass control to the next route callback.

Example:

router.route('/foo/', 'loadContent', function (req, res, next) {
                Y.one('container').setHTML(res.content.node);
                Y.config.doc.title = res.content.title;
            });

Attributes

addPjaxParam

Boolean

Defined in pjax/js/pjax-content.js:204

Available since 3.5.0

If true, a "pjax=1" query parameter will be appended to all URLs requested via Pjax.

Browsers ignore HTTP request headers when caching content, so if the same URL is used to request a partial Pjax page and a full page, the browser will cache them under the same key and may later load the cached partial page when the user actually requests a full page (or vice versa).

To prevent this, we can add a bogus query parameter to the URL so that Pjax URLs will always be cached separately from non-Pjax URLs.

Default: true

Fires event addPjaxParamChange

Fires when the value for the configuration attribute addPjaxParam is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

contentSelector

String

Defined in pjax/js/pjax-content.js:226

Available since 3.5.0

CSS selector used to extract a specific portion of the content of a page loaded via Pjax.

For example, if you wanted to load the page example.html but only use the content within an element with the id "pjax-content", you'd set contentSelector to "#pjax-content".

If not set, the entire page will be used.

Default: null

Fires event contentSelectorChange

Fires when the value for the configuration attribute contentSelector is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

timeout

Number

Defined in pjax/js/pjax-content.js:263

Available since 3.5.0

Time in milliseconds after which an Ajax request should time out.

Default: 30000

Fires event timeoutChange

Fires when the value for the configuration attribute timeout is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.

titleSelector

String

Defined in pjax/js/pjax-content.js:245

Available since 3.5.0

CSS selector used to extract a page title from the content of a page loaded via Pjax.

By default this is set to extract the title from the <title> element, but you could customize it to extract the title from an <h1>, or from any other element, if that's more appropriate for the content you're loading.

Default: "title"

Fires event titleSelectorChange

Fires when the value for the configuration attribute titleSelector is changed. You can listen for the event using the on method if you wish to be notified before the attribute's value has changed, or using the after method if you wish to be notified after the attribute's value has changed.

Parameters:

  • e EventFacade
    An Event Facade object with the following attribute-specific properties added:
    • prevVal Any
      The value of the attribute, prior to it being set.
    • newVal Any
      The value the attribute is to be set to.
    • attrName String
      The name of the attribute being set.
    • subAttrName String
      If setting a property within the attribute's value, the name of the sub-attribute property being set.