build/pjax-base/pjax-base.js

	pjax-base.js revision 981bda63386341f62cfef09ea0d6b522db9579a9
YUI.add('pjax-base', function(Y) {

var win = Y.config.win,

    CLASS_PJAX   = Y.ClassNameManager.getClassName('pjax'),
    EVT_NAVIGATE = 'navigate';

// PjaxBase is a mixin for Router.
function PjaxBase() {}

PjaxBase.prototype = {
    // -- Properties -----------------------------------------------------------
    _resolved: {},
    _regexUrl: /^((?:([^:]+):(?:\/\/)?|\/\/)[^\/]*)?([^?#]*)(.*)$/i,

    // -- Lifecycle Methods ----------------------------------------------------
    initializer: function () {
        this.publish(EVT_NAVIGATE, {defaultFn: this._defNavigateFn});

        if (this.get('html5')) {
            this._pjaxBindUI();
        }
    },

    destructor: function () {
        this._pjaxEvents && this._pjaxEvents.detach();
    },

    // -- Public Prototype Methods ---------------------------------------------
    navigate: function (url, options) {
        options || (options = {});
        options.url = url;

        this.fire(EVT_NAVIGATE, options);
    },

    // -- Protected Prototype Methods ------------------------------------------
    _getRoot: function () {
        var segments = (win && win.location.pathname.split('/')) || [];
        segments.pop();
        return segments.join('/');
    },

    _normalizePath: function (path) {
        var dots  = '..',
            slash = '/',
            i, len, normalized, parts, part, stack;

        if (!path) {
            return path;
        }

        parts = path.split(slash);
        stack = [];

        for (i = 0, len = parts.length; i < len; ++i) {
            part = parts[i];

            if (part === dots) {
                stack.pop();
            } else if (part) {
                stack.push(part);
            }
        }

        normalized = stack.join(slash);

        // Append a slash if necessary.
        if (path.charAt(path.length - 1) === slash) {
            normalized += slash;
        }

        return normalized;
    },

    _pjaxBindUI: function () {
        if (!this._pjaxEvents) {
            this._pjaxEvents = Y.one('body').delegate('click',
                this._onLinkClick, this.get('linkSelector'), this);
        }
    },

    _resolvePath: function (path, root) {
        root || (root = this._getRoot());

        if (!path) {
            return root;
        }

        // Path is host relative.
        if (path.charAt(0) === '/') {
            return path;
        }

        return this._normalizePath(root + '/' + path);
    },

    _resolveUrl: function (url) {
        var self = this,
            root = self._getRoot(),
            resolved, resolvedUrl;

        resolved    = self._resolved[root] || (self._resolved[root] = {});
        resolvedUrl = resolved[url];

        if (resolvedUrl) {
            return resolvedUrl;
        }

        function resolve(match, prefix, scheme, path, suffix) {
            if (scheme && scheme.toLowerCase().indexOf('http') !== 0) {
                return match;
            }

            return (prefix || '') + self._resolvePath(path, root) + (suffix || '');
        }

        // Cache resolved URL.
        resolvedUrl = resolved[url] = url.replace(self._regexUrl, resolve);

        return resolvedUrl;
    },

    // -- Protected Event Handlers ---------------------------------------------
    _defNavigateFn: function (e) {
        this.save(this._resolveUrl(e.url));

        if (this.get('scrollToTop') && Y.config.win) {
            // Scroll to the top of the page. The timeout ensures that the
            // scroll happens after navigation begins, so that the current
            // scroll position will be restored if the user clicks the back
            // button.
            setTimeout(function () {
                Y.config.win.scroll(0, 0);
            }, 1);
        }
    },

    _onLinkClick: function (e) {
        var url = this._resolveUrl(e.currentTarget.get('href'));

        // Allow the native behavior on middle/right-click, or when Ctrl or
        // Command are pressed.
        if (e.button !== 1 || e.ctrlKey || e.metaKey) { return; }

        // Do nothing if there's no matching route for this URL.
        if (!this.hasRoute(url)) { return; }

        e.preventDefault();

        this.navigate(url, {originEvent: e});
    }
};

PjaxBase.ATTRS = {
    linkSelector: {
        value    : 'a.' + CLASS_PJAX,
        writeOnce: 'initOnly'
    },

    scrollToTop: {
        value: true
    }
};

Y.PjaxBase = PjaxBase;


}, '@VERSION@' ,{requires:['classnamemanager', 'node-event-delegate', 'router']});