jellyfin-web/dashboard-ui/thirdparty/jquerymobile-1.4.5/jquery.mobile.custom.js
2016-02-07 14:47:09 -05:00

1746 lines
70 KiB
JavaScript

/*
* jQuery Mobile v1.4.5
* http://jquerymobile.com
*
* Copyright 2010, 2014 jQuery Foundation, Inc. and other contributors
* Released under the MIT license.
* http://jquery.org/license
*
*/
(function (root, doc, factory) {
// Browser globals
factory(root.jQuery, root, doc);
}(this, document, function (jQuery, window, document, undefined) {
jQuery.mobile = {};
(function ($, window, undefined) {
function parentWithClass(elem, className) {
while (!elem.classList || !elem.classList.contains(className)) {
elem = elem.parentNode;
if (!elem) {
return null;
}
}
return elem;
}
$.extend($.mobile, {
// Place to store various widget extensions
behaviors: {},
getClosestBaseUrl: function (ele) {
var page = parentWithClass(ele, 'ui-page');
// Find the closest page and extract out its url.
var url = (page ? page.getAttribute("data-url") : null),
base = $.mobile.path.documentBase.hrefNoHash;
if (!url || !$.mobile.path.isPath(url)) {
url = base;
}
return $.mobile.path.makeUrlAbsolute(url, base);
}
});
// plugins
$.fn.extend({
// Enhance child elements
enhanceWithin: function () {
var index,
widgetElements = {},
that = this;
// Enhance widgets
$.each($.mobile.widgets, function (name, constructor) {
// If initSelector not false find elements
if (constructor.initSelector) {
// Filter elements that should not be enhanced based on parents
var elements = that[0].querySelectorAll(constructor.initSelector);
// Enhance whatever is left
if (elements.length > 0) {
widgetElements[constructor.prototype.widgetName] = $(elements);
}
}
});
for (index in widgetElements) {
widgetElements[index][index]();
}
return this;
}
});
})(jQuery, this);
var previousState = {};
// This is just a temporary api until jquery mobile is eventually deprecated and we have an actual routing library
jQuery.onStatePushed = function(state) {
previousState = state;
};
function ignorePopState(event) {
var state = event.state || {};
if (previousState.navigate === false) {
// Ignore
previousState = state;
return true;
}
previousState = state;
return false;
}
function fireNavigateFromPopstateEvent(event) {
var state = event.state || {};
if (event.historyState) {
$.extend(state, event.historyState);
}
window.dispatchEvent(new CustomEvent("navigate", {
detail: {
state: state,
originalEvent: event
}
}));
}
jQuery.mobile.widgets = {};
// For backcompat remove in 1.5
jQuery(document).on("create", function (event) {
jQuery(event.target).enhanceWithin();
});
(function ($, undefined) {
var path, $base;
$.mobile.path = path = {
uiStateKey: "&ui-state",
// This scary looking regular expression parses an absolute URL or its relative
// variants (protocol, site, document, query, and hash), into the various
// components (protocol, host, path, query, fragment, etc that make up the
// URL as well as some other commonly used sub-parts. When used with RegExp.exec()
// or String.match, it parses the URL into a results array that looks like this:
//
// [0]: http://jblas:password@mycompany.com:8080/mail/inbox?msg=1234&type=unread#msg-content
// [1]: http://jblas:password@mycompany.com:8080/mail/inbox?msg=1234&type=unread
// [2]: http://jblas:password@mycompany.com:8080/mail/inbox
// [3]: http://jblas:password@mycompany.com:8080
// [4]: http:
// [5]: //
// [6]: jblas:password@mycompany.com:8080
// [7]: jblas:password
// [8]: jblas
// [9]: password
// [10]: mycompany.com:8080
// [11]: mycompany.com
// [12]: 8080
// [13]: /mail/inbox
// [14]: /mail/
// [15]: inbox
// [16]: ?msg=1234&type=unread
// [17]: #msg-content
//
urlParseRE: /^\s*(((([^:\/#\?]+:)?(?:(\/\/)((?:(([^:@\/#\?]+)(?:\:([^:@\/#\?]+))?)@)?(([^:\/#\?\]\[]+|\[[^\/\]@#?]+\])(?:\:([0-9]+))?))?)?)?((\/?(?:[^\/\?#]+\/+)*)([^\?#]*)))?(\?[^#]+)?)(#.*)?/,
// Abstraction to address xss (Issue #4787) by removing the authority in
// browsers that auto-decode it. All references to location.href should be
// replaced with a call to this method so that it can be dealt with properly here
getLocation: function (url) {
var parsedUrl = this.parseUrl(url || location.href),
uri = url ? parsedUrl : location,
// Make sure to parse the url or the location object for the hash because using
// location.hash is autodecoded in firefox, the rest of the url should be from
// the object (location unless we're testing) to avoid the inclusion of the
// authority
hash = parsedUrl.hash;
// mimic the browser with an empty string when the hash is empty
hash = hash === "#" ? "" : hash;
return uri.protocol +
parsedUrl.doubleSlash +
uri.host +
// The pathname must start with a slash if there's a protocol, because you
// can't have a protocol followed by a relative path. Also, it's impossible to
// calculate absolute URLs from relative ones if the absolute one doesn't have
// a leading "/".
((uri.protocol !== "" && uri.pathname.substring(0, 1) !== "/") ?
"/" : "") +
uri.pathname +
uri.search +
hash;
},
//return the original document url
getDocumentUrl: function (asParsedObject) {
return asParsedObject ? $.extend({}, path.documentUrl) : path.documentUrl.href;
},
parseLocation: function () {
return this.parseUrl(this.getLocation());
},
//Parse a URL into a structure that allows easy access to
//all of the URL components by name.
parseUrl: function (url) {
// If we're passed an object, we'll assume that it is
// a parsed url object and just return it back to the caller.
if ($.type(url) === "object") {
return url;
}
var matches = path.urlParseRE.exec(url || "") || [];
// Create an object that allows the caller to access the sub-matches
// by name. Note that IE returns an empty string instead of undefined,
// like all other browsers do, so we normalize everything so its consistent
// no matter what browser we're running on.
return {
href: matches[0] || "",
hrefNoHash: matches[1] || "",
hrefNoSearch: matches[2] || "",
domain: matches[3] || "",
protocol: matches[4] || "",
doubleSlash: matches[5] || "",
authority: matches[6] || "",
username: matches[8] || "",
password: matches[9] || "",
host: matches[10] || "",
hostname: matches[11] || "",
port: matches[12] || "",
pathname: matches[13] || "",
directory: matches[14] || "",
filename: matches[15] || "",
search: matches[16] || "",
hash: matches[17] || ""
};
},
//Turn relPath into an asbolute path. absPath is
//an optional absolute path which describes what
//relPath is relative to.
makePathAbsolute: function (relPath, absPath) {
var absStack,
relStack,
i, d;
if (relPath && relPath.charAt(0) === "/") {
return relPath;
}
relPath = relPath || "";
absPath = absPath ? absPath.replace(/^\/|(\/[^\/]*|[^\/]+)$/g, "") : "";
absStack = absPath ? absPath.split("/") : [];
relStack = relPath.split("/");
for (i = 0; i < relStack.length; i++) {
d = relStack[i];
switch (d) {
case ".":
break;
case "..":
if (absStack.length) {
absStack.pop();
}
break;
default:
absStack.push(d);
break;
}
}
return "/" + absStack.join("/");
},
//Returns true if both urls have the same domain.
isSameDomain: function (absUrl1, absUrl2) {
return path.parseUrl(absUrl1).domain.toLowerCase() ===
path.parseUrl(absUrl2).domain.toLowerCase();
},
//Returns true for any relative variant.
isRelativeUrl: function (url) {
// All relative Url variants have one thing in common, no protocol.
return path.parseUrl(url).protocol === "";
},
//Returns true for an absolute url.
isAbsoluteUrl: function (url) {
return path.parseUrl(url).protocol !== "";
},
//Turn the specified realtive URL into an absolute one. This function
//can handle all relative variants (protocol, site, document, query, fragment).
makeUrlAbsolute: function (relUrl, absUrl) {
if (!path.isRelativeUrl(relUrl)) {
return relUrl;
}
if (absUrl === undefined) {
absUrl = this.documentBase;
}
var relObj = path.parseUrl(relUrl),
absObj = path.parseUrl(absUrl),
protocol = relObj.protocol || absObj.protocol,
doubleSlash = relObj.protocol ? relObj.doubleSlash : (relObj.doubleSlash || absObj.doubleSlash),
authority = relObj.authority || absObj.authority,
hasPath = relObj.pathname !== "",
pathname = path.makePathAbsolute(relObj.pathname || absObj.filename, absObj.pathname),
search = relObj.search || (!hasPath && absObj.search) || "",
hash = relObj.hash;
return protocol + doubleSlash + authority + pathname + search + hash;
},
convertUrlToDataUrl: function (absUrl) {
var result = absUrl,
u = path.parseUrl(absUrl);
if (path.isEmbeddedPage(u)) {
// For embedded pages, remove the dialog hash key as in getFilePath(),
// and remove otherwise the Data Url won't match the id of the embedded Page.
result = u.hash
.replace(/^#/, "")
.replace(/\?.*$/, "");
} else if (path.isSameDomain(u, this.documentBase)) {
result = u.hrefNoHash.replace(this.documentBase.domain, "");
}
return window.decodeURIComponent(result);
},
//get path from current hash, or from a file path
get: function (newPath) {
if (newPath === undefined) {
newPath = path.parseLocation().hash;
}
return path.stripHash(newPath).replace(/[^\/]*\.[^\/*]+$/, "");
},
//set location hash to path
set: function (path) {
location.hash = path;
},
//test if a given url (string) is a path
//NOTE might be exceptionally naive
isPath: function (url) {
return (/\//).test(url);
},
//return a url path with the window's location protocol/hostname/pathname removed
clean: function (url) {
return url.replace(this.documentBase.domain, "");
},
//just return the url without an initial #
stripHash: function (url) {
return url.replace(/^#/, "");
},
stripQueryParams: function (url) {
return url.replace(/\?.*$/, "");
},
//remove the preceding hash, any query params, and dialog notations
cleanHash: function (hash) {
return path.stripHash(hash.replace(/\?.*$/, ""));
},
isHashValid: function (hash) {
return (/^#[^#]+$/).test(hash);
},
//check whether a url is referencing the same domain, or an external domain or different protocol
//could be mailto, etc
isExternal: function (url) {
var u = path.parseUrl(url);
return !!(u.protocol &&
(u.domain.toLowerCase() !== this.documentUrl.domain.toLowerCase()));
},
hasProtocol: function (url) {
return (/^(:?\w+:)/).test(url);
},
isEmbeddedPage: function (url) {
var u = path.parseUrl(url);
//if the path is absolute, then we need to compare the url against
//both the this.documentUrl and the documentBase. The main reason for this
//is that links embedded within external documents will refer to the
//application document, whereas links embedded within the application
//document will be resolved against the document base.
if (u.protocol !== "") {
return (!this.isPath(u.hash) && u.hash && (u.hrefNoHash === this.documentUrl.hrefNoHash || (this.documentBaseDiffers && u.hrefNoHash === this.documentBase.hrefNoHash)));
}
return (/^#/).test(u.href);
},
squash: function (url, resolutionUrl) {
var href, cleanedUrl, search, stateIndex, docUrl,
isPath = this.isPath(url),
uri = this.parseUrl(url),
preservedHash = uri.hash,
uiState = "";
// produce a url against which we can resolve the provided path
if (!resolutionUrl) {
if (isPath) {
resolutionUrl = path.getLocation();
} else {
docUrl = path.getDocumentUrl(true);
if (path.isPath(docUrl.hash)) {
resolutionUrl = path.squash(docUrl.href);
} else {
resolutionUrl = docUrl.href;
}
}
}
// If the url is anything but a simple string, remove any preceding hash
// eg #foo/bar -> foo/bar
// #foo -> #foo
cleanedUrl = isPath ? path.stripHash(url) : url;
// If the url is a full url with a hash check if the parsed hash is a path
// if it is, strip the #, and use it otherwise continue without change
cleanedUrl = path.isPath(uri.hash) ? path.stripHash(uri.hash) : cleanedUrl;
// Split the UI State keys off the href
stateIndex = cleanedUrl.indexOf(this.uiStateKey);
// store the ui state keys for use
if (stateIndex > -1) {
uiState = cleanedUrl.slice(stateIndex);
cleanedUrl = cleanedUrl.slice(0, stateIndex);
}
// make the cleanedUrl absolute relative to the resolution url
href = path.makeUrlAbsolute(cleanedUrl, resolutionUrl);
// grab the search from the resolved url since parsing from
// the passed url may not yield the correct result
search = this.parseUrl(href).search;
// TODO all this crap is terrible, clean it up
if (isPath) {
// reject the hash if it's a path or it's just a dialog key
if (path.isPath(preservedHash) || preservedHash.replace("#", "").indexOf(this.uiStateKey) === 0) {
preservedHash = "";
}
// Append the UI State keys where it exists and it's been removed
// from the url
if (uiState && preservedHash.indexOf(this.uiStateKey) === -1) {
preservedHash += uiState;
}
// make sure that pound is on the front of the hash
if (preservedHash.indexOf("#") === -1 && preservedHash !== "") {
preservedHash = "#" + preservedHash;
}
// reconstruct each of the pieces with the new search string and hash
href = path.parseUrl(href);
href = href.protocol + href.doubleSlash + href.host + href.pathname + search +
preservedHash;
} else {
href += href.indexOf("#") > -1 ? uiState : "#" + uiState;
}
return href;
},
isPreservableHash: function (hash) {
return hash.replace("#", "").indexOf(this.uiStateKey) === 0;
},
// Escape weird characters in the hash if it is to be used as a selector
hashToSelector: function (hash) {
var hasHash = (hash.substring(0, 1) === "#");
if (hasHash) {
hash = hash.substring(1);
}
return (hasHash ? "#" : "") + hash.replace(/([!"#$%&'()*+,./:;<=>?@[\]^`{|}~])/g, "\\$1");
},
// check if the specified url refers to the first page in the main
// application document.
isFirstPageUrl: function (url) {
// We only deal with absolute paths.
var u = path.parseUrl(path.makeUrlAbsolute(url, this.documentBase)),
// Does the url have the same path as the document?
samePath = u.hrefNoHash === this.documentUrl.hrefNoHash ||
(this.documentBaseDiffers &&
u.hrefNoHash === this.documentBase.hrefNoHash),
// Get the first page element.
fp = $.mobile.firstPage,
// Get the id of the first page element if it has one.
fpId = fp && fp[0] ? fp[0].id : undefined;
// The url refers to the first page if the path matches the document and
// it either has no hash value, or the hash is exactly equal to the id
// of the first page element.
return samePath &&
(!u.hash ||
u.hash === "#" ||
(fpId && u.hash.replace(/^#/, "") === fpId));
}
};
path.documentUrl = path.parseLocation();
$base = $("head").find("base");
path.documentBase = $base.length ?
path.parseUrl(path.makeUrlAbsolute($base.attr("href"), path.documentUrl.href)) :
path.documentUrl;
path.documentBaseDiffers = (path.documentUrl.hrefNoHash !== path.documentBase.hrefNoHash);
//return the original document base url
path.getDocumentBase = function (asParsedObject) {
return asParsedObject ? $.extend({}, path.documentBase) : path.documentBase.href;
};
// DEPRECATED as of 1.4.0 - remove in 1.5.0
$.extend($.mobile, {
//return the original document url
getDocumentUrl: path.getDocumentUrl,
//return the original document base url
getDocumentBase: path.getDocumentBase
});
})(jQuery);
(function ($, undefined) {
$.mobile.History = function (stack, index) {
this.stack = stack || [];
this.activeIndex = index || 0;
};
$.extend($.mobile.History.prototype, {
getActive: function () {
return this.stack[this.activeIndex];
},
getLast: function () {
return this.stack[this.previousIndex];
},
getNext: function () {
return this.stack[this.activeIndex + 1];
},
getPrev: function () {
return this.stack[this.activeIndex - 1];
},
// addNew is used whenever a new page is added
add: function (url, data) {
data = data || {};
//if there's forward history, wipe it
if (this.getNext()) {
this.clearForward();
}
// if the hash is included in the data make sure the shape
// is consistent for comparison
if (data.hash && data.hash.indexOf("#") === -1) {
data.hash = "#" + data.hash;
}
data.url = url;
this.stack.push(data);
this.activeIndex = this.stack.length - 1;
},
//wipe urls ahead of active index
clearForward: function () {
this.stack = this.stack.slice(0, this.activeIndex + 1);
},
find: function (url, stack, earlyReturn) {
stack = stack || this.stack;
var entry, i, length = stack.length, index;
for (i = 0; i < length; i++) {
entry = stack[i];
if (decodeURIComponent(url) === decodeURIComponent(entry.url) ||
decodeURIComponent(url) === decodeURIComponent(entry.hash)) {
index = i;
if (earlyReturn) {
return index;
}
}
}
return index;
},
closest: function (url) {
var closest, a = this.activeIndex;
// First, take the slice of the history stack before the current index and search
// for a url match. If one is found, we'll avoid avoid looking through forward history
// NOTE the preference for backward history movement is driven by the fact that
// most mobile browsers only have a dedicated back button, and users rarely use
// the forward button in desktop browser anyhow
closest = this.find(url, this.stack.slice(0, a));
// If nothing was found in backward history check forward. The `true`
// value passed as the third parameter causes the find method to break
// on the first match in the forward history slice. The starting index
// of the slice must then be added to the result to get the element index
// in the original history stack :( :(
//
// TODO this is hyper confusing and should be cleaned up (ugh so bad)
if (closest === undefined) {
closest = this.find(url, this.stack.slice(a), true);
closest = closest === undefined ? closest : closest + a;
}
return closest;
},
direct: function (opts) {
var newActiveIndex = this.closest(opts.url), a = this.activeIndex;
// save new page index, null check to prevent falsey 0 result
// record the previous index for reference
if (newActiveIndex !== undefined) {
this.activeIndex = newActiveIndex;
this.previousIndex = a;
}
// invoke callbacks where appropriate
//
// TODO this is also convoluted and confusing
if (newActiveIndex < a) {
(opts.present || opts.back || $.noop)(this.getActive(), "back");
} else if (newActiveIndex > a) {
(opts.present || opts.forward || $.noop)(this.getActive(), "forward");
} else if (newActiveIndex === undefined && opts.missing) {
opts.missing(this.getActive());
}
}
});
})(jQuery);
(function ($, undefined) {
var path = $.mobile.path,
initialHref = location.href;
$.mobile.Navigator = function (history) {
this.history = history;
this.ignoreInitialHashChange = true;
window.addEventListener('popstate', $.proxy(this.popstate, this));
};
$.extend($.mobile.Navigator.prototype, {
squash: function (url, data) {
var state, href, hash = path.isPath(url) ? path.stripHash(url) : url;
href = path.squash(url);
// make sure to provide this information when it isn't explicitly set in the
// data object that was passed to the squash method
state = $.extend({
hash: hash,
url: href
}, data);
// replace the current url with the new href and store the state
// Note that in some cases we might be replacing an url with the
// same url. We do this anyways because we need to make sure that
// all of our history entries have a state object associated with
// them. This allows us to work around the case where $.mobile.back()
// is called to transition from an external page to an embedded page.
// In that particular case, a hashchange event is *NOT* generated by the browser.
// Ensuring each history entry has a state object means that onPopState()
// will always trigger our hashchange callback even when a hashchange event
// is not fired.
window.history.replaceState(state, state.title || document.title, href);
return state;
},
hash: function (url, href) {
var parsed, loc, hash, resolved;
// Grab the hash for recording. If the passed url is a path
// we used the parsed version of the squashed url to reconstruct,
// otherwise we assume it's a hash and store it directly
parsed = path.parseUrl(url);
loc = path.parseLocation();
if (loc.pathname + loc.search === parsed.pathname + parsed.search) {
// If the pathname and search of the passed url is identical to the current loc
// then we must use the hash. Otherwise there will be no event
// eg, url = "/foo/bar?baz#bang", location.href = "http://example.com/foo/bar?baz"
hash = parsed.hash ? parsed.hash : parsed.pathname + parsed.search;
} else if (path.isPath(url)) {
resolved = path.parseUrl(href);
// If the passed url is a path, make it domain relative and remove any trailing hash
hash = resolved.pathname + resolved.search + (path.isPreservableHash(resolved.hash) ? resolved.hash.replace("#", "") : "");
} else {
hash = url;
}
return hash;
},
// TODO reconsider name
go: function (url, data, noEvents) {
var state, href, hash, popstateEvent;
// Get the url as it would look squashed on to the current resolution url
href = path.squash(url);
// sort out what the hash sould be from the url
hash = this.hash(url, href);
// Here we prevent the next hash change or popstate event from doing any
// history management. In the case of hashchange we don't swallow it
// if there will be no hashchange fired (since that won't reset the value)
// and will swallow the following hashchange
if (noEvents && hash !== path.stripHash(path.parseLocation().hash)) {
this.preventNextHashChange = noEvents;
}
// IMPORTANT in the case where popstate is supported the event will be triggered
// directly, stopping further execution - ie, interupting the flow of this
// method call to fire bindings at this expression. Below the navigate method
// there is a binding to catch this event and stop its propagation.
//
// We then trigger a new popstate event on the window with a null state
// so that the navigate events can conclude their work properly
//
// if the url is a path we want to preserve the query params that are available on
// the current url.
this.preventHashAssignPopState = true;
window.location.hash = hash;
// If popstate is enabled and the browser triggers `popstate` events when the hash
// is set (this often happens immediately in browsers like Chrome), then the
// this flag will be set to false already. If it's a browser that does not trigger
// a `popstate` on hash assignement or `replaceState` then we need avoid the branch
// that swallows the event created by the popstate generated by the hash assignment
// At the time of this writing this happens with Opera 12 and some version of IE
if (!browserInfo.safari) {
this.preventHashAssignPopState = false;
}
state = $.extend({
url: href,
hash: hash,
title: document.title
}, data);
this.squash(url, state);
// Trigger a new faux popstate event to replace the one that we
// caught that was triggered by the hash setting above.
if (!noEvents) {
this.ignorePopState = true;
//$(window).trigger(popstateEvent);
window.dispatchEvent(new CustomEvent("popstate", {
detail: {
originalEvent: {
type: "popstate",
state: null
}
}
}));
}
// record the history entry so that the information can be included
// in hashchange event driven navigate events in a similar fashion to
// the state that's provided by popstate
this.history.add(state.url, state);
},
// This binding is intended to catch the popstate events that are fired
// when execution of the `$.navigate` method stops at window.location.hash = url;
// and completely prevent them from propagating. The popstate event will then be
// retriggered after execution resumes
//
// TODO grab the original event here and use it for the synthetic event in the
// second half of the navigate execution that will follow this binding
popstate: function (event) {
if (ignorePopState(event)) {
return;
}
setTimeout(function () {
fireNavigateFromPopstateEvent(event);
}, 0);
var hash, state;
// If this is the popstate triggered by the actual alteration of the hash
// prevent it completely. History is tracked manually
if (this.preventHashAssignPopState) {
this.preventHashAssignPopState = false;
event.stopImmediatePropagation();
return;
}
// if this is the popstate triggered after the `replaceState` call in the go
// method, then simply ignore it. The history entry has already been captured
if (this.ignorePopState) {
this.ignorePopState = false;
return;
}
var originalEventState = event.state || (event.detail ? event.detail.originalEvent.state : event.state);
// If there is no state, and the history stack length is one were
// probably getting the page load popstate fired by browsers like chrome
// avoid it and set the one time flag to false.
// TODO: Do we really need all these conditions? Comparing location hrefs
// should be sufficient.
if (!originalEventState &&
this.history.stack.length === 1 &&
this.ignoreInitialHashChange) {
this.ignoreInitialHashChange = false;
if (location.href === initialHref) {
event.preventDefault();
return;
}
}
// account for direct manipulation of the hash. That is, we will receive a popstate
// when the hash is changed by assignment, and it won't have a state associated. We
// then need to squash the hash. See below for handling of hash assignment that
// matches an existing history entry
// TODO it might be better to only add to the history stack
// when the hash is adjacent to the active history entry
hash = path.parseLocation().hash;
if (!originalEventState && hash) {
// squash the hash that's been assigned on the URL with replaceState
// also grab the resulting state object for storage
state = this.squash(hash);
// record the new hash as an additional history entry
// to match the browser's treatment of hash assignment
this.history.add(state.url, state);
// pass the newly created state information
// along with the event
event.historyState = state;
// do not alter history, we've added a new history entry
// so we know where we are
return;
}
// If all else fails this is a popstate that comes from the back or forward buttons
// make sure to set the state of our history stack properly, and record the directionality
this.history.direct({
url: (originalEventState || {}).url || hash,
// When the url is either forward or backward in history include the entry
// as data on the event object for merging as data in the navigate event
present: function (historyEntry, direction) {
// make sure to create a new object to pass down as the navigate event data
event.historyState = $.extend({}, historyEntry);
event.historyState.direction = direction;
}
});
}
});
})(jQuery);
(function ($, undefined) {
// TODO consider queueing navigation activity until previous activities have completed
// so that end users don't have to think about it. Punting for now
// TODO !! move the event bindings into callbacks on the navigate event
$.mobile.navigate = function (url, data, noEvents) {
$.mobile.navigate.navigator.go(url, data, noEvents);
};
// expose the history on the navigate method in anticipation of full integration with
// existing navigation functionalty that is tightly coupled to the history information
$.mobile.navigate.history = new $.mobile.History();
// instantiate an instance of the navigator for use within the $.navigate method
$.mobile.navigate.navigator = new $.mobile.Navigator($.mobile.navigate.history);
var loc = $.mobile.path.parseLocation();
$.mobile.navigate.history.add(loc.href, { hash: loc.hash });
})(jQuery);
(function ($, undefined) {
function jqmPage(pageElem) {
var self = this;
if (pageElem.hasPage) {
return;
}
pageElem.hasPage = true;
pageElem.dispatchEvent(new CustomEvent("pagecreate", {
bubbles: true
}));
self.element = $(pageElem);
self.options = {
theme: pageElem.getAttribute('data-theme') || 'a'
};
self._enhance = function () {
var attrPrefix = "data-";
var element = self.element[0];
element.setAttribute("data-role", 'page');
element.setAttribute("tabindex", "0");
element.classList.add("ui-page");
element.classList.add("ui-page-theme-" + self.options.theme);
var contents = element.querySelectorAll("div[data-role='content']");
for (var i = 0, length = contents.length; i < length; i++) {
var content = contents[i];
var theme = content.getAttribute(attrPrefix + "theme") || undefined;
self.options.contentTheme = theme || self.options.contentTheme || (self.options.dialog && self.options.theme) || (self.element.data("role") === "dialog" && self.options.theme);
content.classList.add("ui-content");
if (self.options.contentTheme) {
content.classList.add("ui-body-" + (self.options.contentTheme));
}
// Add ARIA role
content.setAttribute("role", "main");
content.classList.add("ui-content");
}
};
self._enhance();
self.element.enhanceWithin();
pageElem.dispatchEvent(new CustomEvent("pageinit", {
bubbles: true
}));
}
var pageCache = {};
function pageContainer(containerElem) {
var self = this;
self.element = containerElem;
self.initSelector = false;
window.addEventListener("navigate", function (e) {
var url;
if (e.defaultPrevented) {
return;
}
var originalEvent = e.detail.originalEvent;
if (originalEvent && originalEvent.defaultPrevented) {
return;
}
var data = e.detail;
url = originalEvent.type.indexOf("hashchange") > -1 ? data.state.hash : data.state.url;
if (!url) {
url = $.mobile.path.parseLocation().hash;
}
if (!url || url === "#" || url.indexOf("#" + $.mobile.path.uiStateKey) === 0) {
url = location.href;
}
self._handleNavigate(url, data.state);
});
self.back = function () {
self.go(-1);
};
self.forward = function () {
self.go(1);
};
self.go = function (steps) {
window.history.go(steps);
};
self._handleDestination = function (to) {
// clean the hash for comparison if it's a url
if ($.type(to) === "string") {
to = $.mobile.path.stripHash(to);
}
if (to) {
// At this point, 'to' can be one of 3 things, a cached page
// element from a history stack entry, an id, or site-relative /
// absolute URL. If 'to' is an id, we need to resolve it against
// the documentBase, not the location.href, since the hashchange
// could've been the result of a forward/backward navigation
// that crosses from an external page/dialog to an internal
// page/dialog.
//
// TODO move check to history object or path object?
to = !$.mobile.path.isPath(to) ? ($.mobile.path.makeUrlAbsolute("#" + to, $.mobile.path.documentBase)) : to;
}
return to || $.mobile.firstPage;
};
self._handleNavigate = function (url, data) {
//find first page via hash
// TODO stripping the hash twice with handleUrl
var to = $.mobile.path.stripHash(url),
// default options for the changPage calls made after examining
// the current state of the page and the hash, NOTE that the
// transition is derived from the previous history entry
changePageOptions = {
changeHash: false,
fromHashChange: true,
reverse: data.direction === "back"
};
$.extend(changePageOptions, data, {
transition: "none"
});
$.mobile.changePage(self._handleDestination(to), changePageOptions);
};
self._enhance = function (content, role) {
new jqmPage(content[0]);
};
self._include = function (page, jPage, settings) {
// append to page and enhance
jPage.appendTo(self.element);
//alert(jPage[0].parentNode == this.element[0]);
//this.element[0].appendChild(page);
// use the page widget to enhance
self._enhance(jPage, settings.role);
};
self._find = function (absUrl) {
// TODO consider supporting a custom callback
var fileUrl = absUrl,
dataUrl = self._createDataUrl(absUrl),
page,
initialContent = $.mobile.firstPage;
// Check to see if the page already exists in the DOM.
page = self.element[0].querySelector("[data-url='" + $.mobile.path.hashToSelector(dataUrl) + "']");
// If we failed to find the page, check to see if the url is a
// reference to an embedded page. If so, it may have been dynamically
// injected by a developer, in which case it would be lacking a
// data-url attribute and in need of enhancement.
if (!page && dataUrl && !$.mobile.path.isPath(dataUrl)) {
page = self.element[0].querySelector($.mobile.path.hashToSelector("#" + dataUrl));
if (page) {
$(page).attr("data-url", dataUrl)
.data("url", dataUrl);
}
}
// If we failed to find a page in the DOM, check the URL to see if it
// refers to the first page in the application. Also check to make sure
// our cached-first-page is actually in the DOM. Some user deployed
// apps are pruning the first page from the DOM for various reasons.
// We check for this case here because we don't want a first-page with
// an id falling through to the non-existent embedded page error case.
if (!page &&
$.mobile.path.isFirstPageUrl(fileUrl) &&
initialContent &&
initialContent.parent().length) {
page = initialContent;
}
return page ? $(page) : $();
};
self._parse = function (html, fileUrl) {
// TODO consider allowing customization of this method. It's very JQM specific
var page, all = document.createElement('div');
//workaround to allow scripts to execute when included in page divs
all.innerHTML = html;
page = all.querySelector("div[data-role='page']");
//if page elem couldn't be found, create one and insert the body element's contents
if (!page) {
page = $("<div data-role='page'>" +
(html.split(/<\/?body[^>]*>/gmi)[1] || "") +
"</div>")[0];
}
// TODO tagging a page with external to make sure that embedded pages aren't
// removed by the various page handling code is bad. Having page handling code
// in many places is bad. Solutions post 1.0
page.setAttribute("data-url", self._createDataUrl(fileUrl));
page.setAttribute("data-external-page", true);
return page;
};
self._setLoadedTitle = function (page, html) {
//page title regexp
if (!page.data("title")) {
var newPageTitle = html.match(/<title[^>]*>([^<]*)/) && RegExp.$1;
if (newPageTitle) {
page.data("title", newPageTitle);
}
}
};
self._createDataUrl = function (absoluteUrl) {
return $.mobile.path.convertUrlToDataUrl(absoluteUrl);
};
self._triggerWithDeprecated = function (name, data, page) {
// trigger the old deprecated event on the page if it's provided
//(page || this.element).trigger(deprecatedEvent, data);
(page || this.element)[0].dispatchEvent(new CustomEvent("page" + name, {
bubbles: true,
detail: {
data: data
}
}));
};
// TODO it would be nice to split this up more but everything appears to be "one off"
// or require ordering such that other bits are sprinkled in between parts that
// could be abstracted out as a group
self._loadSuccess = function (absUrl, settings, deferred) {
var fileUrl = absUrl;
var currentSelf = self;
return function (html, wasCached) {
if (!wasCached || typeof (wasCached) != 'boolean') {
if ($.mobile.filterHtml) {
html = $.mobile.filterHtml(html);
}
if (absUrl.toLowerCase().indexOf('/configurationpage?') == -1) {
pageCache[absUrl.split('?')[0]] = html;
}
}
var contentElem = currentSelf._parse(html, fileUrl);
var content = $(contentElem);
currentSelf._setLoadedTitle(content, html);
var dependencies = contentElem.getAttribute('data-require');
dependencies = dependencies ? dependencies.split(',') : null;
if (contentElem.classList.contains('type-interior')) {
dependencies = dependencies || [];
addLegacyDependencies(dependencies, absUrl);
}
require(dependencies, function () {
currentSelf._include(contentElem, content, settings);
deferred.resolve(absUrl, settings, content);
});
};
};
self._loadDefaults = {
type: "get",
data: undefined,
// DEPRECATED
reloadPage: false,
reload: false,
// By default we rely on the role defined by the @data-role attribute.
role: undefined
};
self.load = function (url, options) {
// This function uses deferred notifications to let callers
// know when the content is done loading, or if an error has occurred.
var deferred = (options && options.deferred) || $.Deferred(),
// The default load options with overrides specified by the caller.
settings = $.extend({}, self._loadDefaults, options),
// The absolute version of the URL passed into the function. This
// version of the URL may contain dialog/subcontent params in it.
absUrl = $.mobile.path.makeUrlAbsolute(url, self._findBaseWithDefault());
var content = self._find(absUrl);
// If it isn't a reference to the first content and refers to missing
// embedded content reject the deferred and return
if (content.length === 0 &&
$.mobile.path.isEmbeddedPage(absUrl) &&
!$.mobile.path.isFirstPageUrl(absUrl)) {
deferred.reject(absUrl, settings);
return deferred.promise();
}
// If the content we are interested in is already in the DOM,
// and the caller did not indicate that we should force a
// reload of the file, we are done. Resolve the deferrred so that
// users can bind to .done on the promise
if (content.length && !settings.reload) {
self._enhance(content, settings.role);
deferred.resolve(absUrl, settings, content);
return deferred.promise();
}
var successFn = self._loadSuccess(absUrl, settings, deferred);
var cachedResult = pageCache[absUrl.split('?')[0]];
if (cachedResult) {
successFn(cachedResult, true);
return deferred.promise();
}
//// Load the new content.
//$.ajax({
// url: fileUrl,
// type: settings.type,
// data: settings.data,
// contentType: settings.contentType,
// dataType: "html",
// success: successFn,
// error: this._loadError(absUrl, triggerData, settings, deferred)
//});
var xhr = new XMLHttpRequest();
xhr.open('GET', absUrl, true);
xhr.onload = function (e) {
successFn(this.response);
};
xhr.send();
return deferred.promise();
};
// TODO move into transition handlers?
self._triggerCssTransitionEvents = function (to, from, prefix) {
prefix = prefix || "";
// TODO decide if these events should in fact be triggered on the container
if (from) {
//trigger before show/hide events
// TODO deprecate nextPage in favor of next
self._triggerWithDeprecated(prefix + "hide", {
// Deprecated in 1.4 remove in 1.5
nextPage: to,
toPage: to,
prevPage: from,
samePage: to[0] === from[0]
}, from);
}
// TODO deprecate prevPage in favor of previous
if (!prefix && browserInfo.msie) {
// Add a delay for IE because it seems to be having issues with web components
setTimeout(function () {
self._triggerWithDeprecated(prefix + "show", {
prevPage: from || $(""),
toPage: to
}, to);
}, 50);
} else {
self._triggerWithDeprecated(prefix + "show", {
prevPage: from || $(""),
toPage: to
}, to);
}
};
// TODO make private once change has been defined in the widget
self._cssTransition = function (to, from, options) {
self._triggerCssTransitionEvents(to, from, "before");
if (from) {
from[0].style.display = 'none';
var pages = self.element[0].childNodes;
for (var i = 0, length = pages.length; i < length; i++) {
var pg = pages[i];
if (pg.getAttribute && pg.getAttribute('data-role') == 'page') {
pg.style.display = 'none';
}
}
}
var toPage = to[0];
toPage.style.display = 'block';
self._triggerCssTransitionEvents(to, from);
};
self.change = function (to, options) {
var settings = $.extend({}, $.mobile.changePage.defaults, options),
triggerData = {};
// Make sure we have a fromPage.
settings.fromPage = settings.fromPage || self.activePage;
triggerData.prevPage = self.activePage;
$.extend(triggerData, {
toPage: to,
options: settings
});
// If the caller passed us a url, call loadPage()
// to make sure it is loaded into the DOM. We'll listen
// to the promise object it returns so we know when
// it is done loading or if an error ocurred.
if ($.type(to) === "string") {
// if the toPage is a string simply convert it
triggerData.absUrl = $.mobile.path.makeUrlAbsolute(to, self._findBaseWithDefault());
// preserve the original target as the dataUrl value will be
// simplified eg, removing ui-state, and removing query params
// from the hash this is so that users who want to use query
// params have access to them in the event bindings for the page
// life cycle See issue #5085
settings.target = to;
settings.deferred = $.Deferred();
self.load(to, settings);
settings.deferred.then($.proxy(function (url, options, content) {
// store the original absolute url so that it can be provided
// to events in the triggerData of the subsequent changePage call
options.absUrl = triggerData.absUrl;
self.transition(content, triggerData, options);
}, self));
} else {
// if the toPage is a jQuery object grab the absolute url stored
// in the loadPage callback where it exists
triggerData.absUrl = settings.absUrl;
self.transition(to, triggerData, settings);
}
};
self.transition = function (toPage, triggerData, settings) {
var fromPage,
url,
pageUrl,
fileUrl,
active,
historyDir,
pageTitle,
alreadyThere,
newPageTitle,
params;
triggerData.prevPage = settings.fromPage;
// If we are going to the first-page of the application, we need to make
// sure settings.dataUrl is set to the application document url. This allows
// us to avoid generating a document url with an id hash in the case where the
// first-page of the document has an id attribute specified.
if (toPage[0] === $.mobile.firstPage[0] && !settings.dataUrl) {
settings.dataUrl = $.mobile.path.documentUrl.hrefNoHash;
}
// The caller passed us a real page DOM element. Update our
// internal state and then trigger a transition to the page.
fromPage = settings.fromPage;
url = (settings.dataUrl && $.mobile.path.convertUrlToDataUrl(settings.dataUrl)) ||
toPage.data("url");
// The pageUrl var is usually the same as url, except when url is obscured
// as a dialog url. pageUrl always contains the file path
pageUrl = url;
fileUrl = url;
active = $.mobile.navigate.history.getActive();
historyDir = 0;
pageTitle = document.title;
// By default, we prevent changePage requests when the fromPage and toPage
// are the same element, but folks that generate content
// manually/dynamically and reuse pages want to be able to transition to
// the same page. To allow this, they will need to change the default
// value of allowSamePageTransition to true, *OR*, pass it in as an
// option when they manually call changePage(). It should be noted that
// our default transition animations assume that the formPage and toPage
// are different elements, so they may behave unexpectedly. It is up to
// the developer that turns on the allowSamePageTransitiona option to
// either turn off transition animations, or make sure that an appropriate
// animation transition is used.
if (fromPage && fromPage[0] === toPage[0]) {
self._triggerWithDeprecated("transition", triggerData);
self._triggerWithDeprecated("change", triggerData);
// Even if there is no page change to be done, we should keep the
// urlHistory in sync with the hash changes
if (settings.fromHashChange) {
$.mobile.navigate.history.direct({ url: url });
}
return;
}
new jqmPage(toPage[0]);
// If the changePage request was sent from a hashChange event, check to
// see if the page is already within the urlHistory stack. If so, we'll
// assume the user hit the forward/back button and will try to match the
// transition accordingly.
if (settings.fromHashChange) {
historyDir = settings.direction === "back" ? -1 : 1;
}
// Record whether we are at a place in history where a dialog used to be -
// if so, do not add a new history entry and do not change the hash either
alreadyThere = false;
// if title element wasn't found, try the page div data attr too
// If this is a deep-link or a reload ( active === undefined ) then just
// use pageTitle
newPageTitle = (!active) ? pageTitle : toPage.data("title");
if (!!newPageTitle && pageTitle === document.title) {
pageTitle = newPageTitle;
}
if (!toPage.data("title")) {
toPage.data("title", pageTitle);
}
//add page to history stack if it's not back or forward
if (!historyDir && alreadyThere) {
$.mobile.navigate.history.getActive().pageUrl = pageUrl;
}
// Set the location hash.
if (url && !settings.fromHashChange) {
// rebuilding the hash here since we loose it earlier on
// TODO preserve the originally passed in path
if (!$.mobile.path.isPath(url) && url.indexOf("#") < 0) {
url = "#" + url;
}
// TODO the property names here are just silly
params = {
title: pageTitle,
pageUrl: pageUrl,
role: settings.role
};
$.mobile.navigate(encodeURI(url), params, true);
}
//set page title
document.title = pageTitle;
//set "toPage" as activePage deprecated in 1.4 remove in 1.5
$.mobile.activePage = toPage;
//new way to handle activePage
self.activePage = toPage;
// If we're navigating back in the URL history, set reverse accordingly.
settings.reverse = settings.reverse || historyDir < 0;
self._cssTransition(toPage, fromPage, {
transition: settings.transition,
reverse: settings.reverse
});
};
// determine the current base url
self._findBaseWithDefault = function () {
var closestBase = (self.activePage &&
$.mobile.getClosestBaseUrl(self.activePage[0]));
return closestBase || $.mobile.path.documentBase.hrefNoHash;
};
}
$.mobile.pageContainerBuilder = pageContainer;
})(jQuery);
(function ($, undefined) {
// resolved on domready
var // function that resolves the above deferred
documentUrl = $.mobile.path.documentUrl;
//define vars for interal use
/* internal utility functions */
// Exposed $.mobile methods
$.mobile.changePage = function (to, options) {
$.mobile.pageContainer.change(to, options);
};
$.mobile.changePage.defaults = {
reverse: false,
changeHash: true,
fromHashChange: false,
role: undefined, // By default we rely on the role defined by the @data-role attribute.
duplicateCachedPage: undefined,
pageContainer: undefined,
dataUrl: undefined,
fromPage: undefined
};
function parentWithTag(elem, tagName) {
while (elem.tagName != tagName) {
elem = elem.parentNode;
if (!elem) {
return null;
}
}
return elem;
}
$.mobile._registerInternalEvents = function () {
// click routing - direct to HTTP or Ajax, accordingly
document.addEventListener("click", function (event) {
var link = parentWithTag(event.target, 'A');
var $link = $(link);
// If there is no link associated with the click or its not a left
// click we want to ignore the click
// TODO teach $.mobile.hijackable to operate on raw dom elements so the link wrapping
// can be avoided
if (!link || event.which > 1) {
return;
}
//if there's a data-rel=back attr, go back in history
if (link.getAttribute('data-rel') == 'back') {
$.mobile.pageContainer.back();
return false;
}
var baseUrl = $.mobile.getClosestBaseUrl(link);
//get href, if defined, otherwise default to empty hash
var href = $.mobile.path.makeUrlAbsolute(link.getAttribute("href") || "#", baseUrl);
// XXX_jblas: Ideally links to application pages should be specified as
// an url to the application document with a hash that is either
// the site relative path or id to the page. But some of the
// internal code that dynamically generates sub-pages for nested
// lists and select dialogs, just write a hash in the link they
// create. This means the actual URL path is based on whatever
// the current value of the base tag is at the time this code
// is called.
if (href.search("#") !== -1 &&
!($.mobile.path.isExternal(href) && $.mobile.path.isAbsoluteUrl(href))) {
href = href.replace(/[^#]*#/, "");
if (!href) {
//link was an empty hash meant purely
//for interaction, so we ignore it.
event.preventDefault();
return;
} else if ($.mobile.path.isPath(href)) {
//we have apath so make it the href we want to load.
href = $.mobile.path.makeUrlAbsolute(href, baseUrl);
} else {
//we have a simple id so use the documentUrl as its base.
href = $.mobile.path.makeUrlAbsolute("#" + href, documentUrl.hrefNoHash);
}
}
// Should we handle this link, or let the browser deal with it?
//check for protocol or rel and its not an embedded page
//TODO overlap in logic from isExternal, rel=external check should be
// moved into more comprehensive isExternalLink
if (link.getAttribute("rel") == "external" || link.getAttribute("data-ajax") == "false" || link.getAttribute('target') || ($.mobile.path.isExternal(href))) {
//use default click handling
return;
}
//use ajax
var reverse = $link.data("direction") === "reverse";
//this may need to be more specific as we use data-rel more
var role = link.getAttribute("data-rel") || undefined;
$.mobile.changePage(href, { reverse: reverse, role: role, link: $link });
event.preventDefault();
});
function removePage(page) {
page.parentNode.removeChild(page);
}
function cleanPages(newPage) {
var pages = document.querySelectorAll("div[data-role='page']");
if (pages.length < 5) {
//return;
}
for (var i = 0, length = pages.length; i < length; i++) {
var page = pages[i];
if (page != newPage) {
removePage(page);
}
}
}
//set page min-heights to be device specific
document.addEventListener("pagehide", function (e) {
var data = e.detail.data;
var toPage = data.toPage ? data.toPage[0] : null;
if (toPage) {
if (toPage.getAttribute('data-dom-cache')) {
cleanPages(toPage);
}
else if ((toPage.getAttribute('data-url') || '').toLowerCase().indexOf('/configurationpage') != -1) {
// plugin config pages are not built to handle the dom caching
cleanPages(toPage);
}
}
});
};
})(jQuery);
jQuery.mobile.initializePage = function () {
// find present pages
var path = $.mobile.path,
firstPage = document.querySelector("div[data-role='page']"),
hash = path.stripHash(path.stripQueryParams(path.parseLocation().hash)),
theLocation = $.mobile.path.parseLocation(),
hashPage = hash ? document.getElementById(hash) : undefined;
// add dialogs, set data-url attrs
if (firstPage) {
// unless the data url is already set set it to the pathname
if (!firstPage.getAttribute("data-url")) {
firstPage.setAttribute("data-url", firstPage.getAttribute("id") || path.convertUrlToDataUrl(theLocation.pathname + theLocation.search));
}
}
// define first page in dom case one backs out to the directory root (not always the first page visited, but defined as fallback)
$.mobile.firstPage = $(firstPage);
// define page container
$.mobile.pageContainer = new $.mobile.pageContainerBuilder($.mobile.firstPage
.parent()
.addClass("ui-mobile-viewport"));
$.mobile._registerInternalEvents();
// if hashchange listening is disabled, there's no hash deeplink,
// the hash is not valid (contains more than one # or does not start with #)
// or there is no page with that hash, change to the first page in the DOM
// Remember, however, that the hash can also be a path!
if (!($.mobile.path.isHashValid(location.hash) &&
($(hashPage).is("[data-role='page']") ||
$.mobile.path.isPath(hash)))) {
// make sure to set initial popstate state if it exists
// so that navigation back to the initial page works properly
$.mobile.navigate.navigator.squash(path.parseLocation().href);
$.mobile.changePage($.mobile.firstPage, {
reverse: true,
changeHash: false,
fromHashChange: true
});
} else {
// TODO figure out how to simplify this interaction with the initial history entry
// at the bottom js/navigate/navigate.js
$.mobile.navigate.history.stack = [];
$.mobile.navigate($.mobile.path.isPath(location.hash) ? location.hash : location.href);
}
};
jQuery.fn.selectmenu = function () {
return this;
};
}));