| Server IP : 172.67.174.47 / Your IP : 216.73.216.87 Web Server : LiteSpeed System : Linux premium151.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64 User : tempvsty ( 647) PHP Version : 8.0.30 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /././././proc/thread-self/cwd/wp-content/plugins/motopress-content-editor/jquery/dom/route/ |
Upload File : |
steal('jquery/lang/observe', 'jquery/event/hashchange', 'jquery/lang/string/deparam',
function( $ ) {
// Helper methods used for matching routes.
var
// RegEx used to match route variables of the type ':name'.
// Any word character or a period is matched.
matcher = /\:([\w\.]+)/g,
// Regular expression for identifying &key=value lists.
paramsMatcher = /^(?:&[^=]+=[^&]*)+/,
// Converts a JS Object into a list of parameters that can be
// inserted into an html element tag.
makeProps = function( props ) {
var html = [],
name, val;
each(props, function(name, val){
if ( name === 'className' ) {
name = 'class'
}
val && html.push(escapeHTML(name), "=\"", escapeHTML(val), "\" ");
})
return html.join("")
},
// Escapes ' and " for safe insertion into html tag parameters.
escapeHTML = function( content ) {
return content.replace(/"/g, '"').replace(/'/g, "'");
},
// Checks if a route matches the data provided. If any route variable
// is not present in the data the route does not match. If all route
// variables are present in the data the number of matches is returned
// to allow discerning between general and more specific routes.
matchesData = function(route, data) {
var count = 0;
for ( var i = 0; i < route.names.length; i++ ) {
if (!data.hasOwnProperty(route.names[i]) ) {
return -1;
}
count++;
}
return count;
},
//
onready = true,
location = window.location,
encode = encodeURIComponent,
decode = decodeURIComponent,
each = $.each,
extend = $.extend;
/**
* @class jQuery.route
* @inherits jQuery.Observe
* @plugin jquery/dom/route
* @parent dom
* @tag 3.2
*
* jQuery.route helps manage browser history (and
* client state) by
* synchronizing the window.location.hash with
* an [jQuery.Observe].
*
* ## Background Information
*
* To support the browser's back button and bookmarking
* in an Ajax application, most applications use
* the <code>window.location.hash</code>. By
* changing the hash (via a link or JavaScript),
* one is able to add to the browser's history
* without changing the page. The [jQuery.event.special.hashchange event] allows
* you to listen to when the hash is changed.
*
* Combined, this provides the basics needed to
* create history enabled Ajax websites. However,
* jQuery.Route addresses several other needs such as:
*
* - Pretty Routes
* - Keeping routes independent of application code
* - Listening to specific parts of the history changing
* - Setup / Teardown of widgets.
*
* ## How it works
*
* <code>$.route</code> is a [jQuery.Observe $.Observe] that represents the
* <code>window.location.hash</code> as an
* object. For example, if the hash looks like:
*
* #!type=videos&id=5
*
* the data in <code>$.route</code> would look like:
*
* { type: 'videos', id: 5 }
*
*
* $.route keeps the state of the hash in-sync with the data in
* $.route.
*
* ## $.Observe
*
* $.route is a [jQuery.Observe $.Observe]. Understanding
* $.Observe is essential for using $.route correctly.
*
* You can
* listen to changes in an Observe with bind and
* delegate and change $.route's properties with
* attr and attrs.
*
* ### Listening to changes in an Observable
*
* Listen to changes in history
* by [jQuery.Observe.prototype.bind bind]ing to
* changes in <code>$.route</code> like:
*
* $.route.bind('change', function(ev, attr, how, newVal, oldVal) {
*
* })
*
* - attr - the name of the changed attribute
* - how - the type of Observe change event (add, set or remove)
* - newVal/oldVal - the new and old values of the attribute
*
* You can also listen to specific changes
* with [jQuery.Observe.prototype.delegate delegate]:
*
* $.route.delegate('id','change', function(){ ... })
*
* Observe lets you listen to the following events:
*
* - change - any change to the object
* - add - a property is added
* - set - a property value is added or changed
* - remove - a property is removed
*
* Listening for <code>add</code> is useful for widget setup
* behavior, <code>remove</code> is useful for teardown.
*
* ### Updating an observable
*
* Create changes in the route data like:
*
* $.route.attr('type','images');
*
* Or change multiple properties at once with
* [jQuery.Observe.prototype.attrs attrs]:
*
* $.route.attr({type: 'pages', id: 5}, true)
*
* When you make changes to $.route, they will automatically
* change the <code>hash</code>.
*
* ## Creating a Route
*
* Use <code>$.route(url, defaults)</code> to create a
* route. A route is a mapping from a url to
* an object (that is the $.route's state).
*
* If no routes are added, or no route is matched,
* $.route's data is updated with the [jQuery.String.deparam deparamed]
* hash.
*
* location.hash = "#!type=videos";
* // $.route -> {type : "videos"}
*
* Once routes are added and the hash changes,
* $.route looks for matching routes and uses them
* to update $.route's data.
*
* $.route( "content/:type" );
* location.hash = "#!content/images";
* // $.route -> {type : "images"}
*
* Default values can also be added:
*
* $.route("content/:type",{type: "videos" });
* location.hash = "#!content/"
* // $.route -> {type : "videos"}
*
* ## Delay setting $.route
*
* By default, <code>$.route</code> sets its initial data
* on document ready. Sometimes, you want to wait to set
* this data. To wait, call:
*
* $.route.ready(false);
*
* and when ready, call:
*
* $.route.ready(true);
*
* ## Changing the route.
*
* Typically, you never want to set <code>location.hash</code>
* directly. Instead, you can change properties on <code>$.route</code>
* like:
*
* $.route.attr('type', 'videos')
*
* This will automatically look up the appropriate
* route and update the hash.
*
* Often, you want to create links. <code>$.route</code> provides
* the [jQuery.route.link] and [jQuery.route.url] helpers to make this
* easy:
*
* $.route.link("Videos", {type: 'videos'})
*
* @param {String} url the fragment identifier to match.
* @param {Object} [defaults] an object of default values
* @return {jQuery.route}
*/
$.route = function( url, defaults ) {
// Extract the variable names and replace with regEx that will match an atual URL with values.
var names = [],
test = url.replace(matcher, function( whole, name ) {
names.push(name)
// TODO: I think this should have a +
return "([^\\/\\&]*)" // The '\\' is for string-escaping giving single '\' for regEx escaping
});
// Add route in a form that can be easily figured out
$.route.routes[url] = {
// A regular expression that will match the route when variable values
// are present; i.e. for :page/:type the regEx is /([\w\.]*)/([\w\.]*)/ which
// will match for any value of :page and :type (word chars or period).
test: new RegExp("^" + test+"($|&)"),
// The original URL, same as the index for this entry in routes.
route: url,
// An array of all the variable names in this route
names: names,
// Default values provided for the variables.
defaults: defaults || {},
// The number of parts in the URL separated by '/'.
length: url.split('/').length
}
return $.route;
};
extend($.route, {
/**
* Parameterizes the raw JS object representation provided in data.
* If a route matching the provided data is found that URL is built
* from the data. Any remaining data is added at the end of the
* URL as & separated key/value parameters.
*
* @param {Object} data
* @return {String} The route URL and & separated parameters.
*/
param: function( data ) {
// Check if the provided data keys match the names in any routes;
// get the one with the most matches.
var route,
// need it to be at least 1 match
matches = 0,
matchCount,
routeName = data.route;
delete data.route;
// if we have a route name in our $.route data, use it
if(routeName && (route = $.route.routes[routeName])){
} else {
// otherwise find route
each($.route.routes, function(name, temp){
matchCount = matchesData(temp, data);
if ( matchCount > matches ) {
route = temp;
matches = matchCount
}
});
}
// if this is match
if ( route ) {
var cpy = extend({}, data),
// Create the url by replacing the var names with the provided data.
// If the default value is found an empty string is inserted.
res = route.route.replace(matcher, function( whole, name ) {
delete cpy[name];
return data[name] === route.defaults[name] ? "" : encode( data[name] );
}),
after;
// remove matching default values
each(route.defaults, function(name,val){
if(cpy[name] === val) {
delete cpy[name]
}
})
// The remaining elements of data are added as
// $amp; separated parameters to the url.
after = $.param(cpy);
return res + (after ? "&" + after : "")
}
// If no route was found there is no hash URL, only paramters.
return $.isEmptyObject(data) ? "" : "&" + $.param(data);
},
/**
* Populate the JS data object from a given URL.
*
* @param {Object} url
*/
deparam: function( url ) {
// See if the url matches any routes by testing it against the route.test regEx.
// By comparing the URL length the most specialized route that matches is used.
var route = {
length: -1
};
each($.route.routes, function(name, temp){
if ( temp.test.test(url) && temp.length > route.length ) {
route = temp;
}
});
// If a route was matched
if ( route.length > -1 ) {
var // Since RegEx backreferences are used in route.test (round brackets)
// the parts will contain the full matched string and each variable (backreferenced) value.
parts = url.match(route.test),
// start will contain the full matched string; parts contain the variable values.
start = parts.shift(),
// The remainder will be the &key=value list at the end of the URL.
remainder = url.substr(start.length - (parts[parts.length-1] === "&" ? 1 : 0) ),
// If there is a remainder and it contains a &key=value list deparam it.
obj = (remainder && paramsMatcher.test(remainder)) ? $.String.deparam( remainder.slice(1) ) : {};
// Add the default values for this route
obj = extend(true, {}, route.defaults, obj);
// Overwrite each of the default values in obj with those in parts if that part is not empty.
each(parts,function(i, part){
if ( part && part !== '&') {
obj[route.names[i]] = decode( part );
}
});
obj.route = route.route;
return obj;
}
// If no route was matched it is parsed as a &key=value list.
if ( url.charAt(0) !== '&' ) {
url = '&' + url;
}
return paramsMatcher.test(url) ? $.String.deparam( url.slice(1) ) : {};
},
/**
* @hide
* A $.Observe that represents the state of the history.
*/
data: new $.Observe({}),
/**
* @attribute
* @type Object
* @hide
*
* A list of routes recognized by the router indixed by the url used to add it.
* Each route is an object with these members:
*
* - test - A regular expression that will match the route when variable values
* are present; i.e. for :page/:type the regEx is /([\w\.]*)/([\w\.]*)/ which
* will match for any value of :page and :type (word chars or period).
*
* - route - The original URL, same as the index for this entry in routes.
*
* - names - An array of all the variable names in this route
*
* - defaults - Default values provided for the variables or an empty object.
*
* - length - The number of parts in the URL separated by '/'.
*/
routes: {},
/**
* Indicates that all routes have been added and sets $.route.data
* based upon the routes and the current hash.
*
* By default, ready is fired on jQuery's ready event. Sometimes
* you might want it to happen sooner or earlier. To do this call
*
* $.route.ready(false); //prevents firing by the ready event
* $.route.ready(true); // fire the first route change
*
* @param {Boolean} [start]
* @return $.route
*/
ready: function(val) {
if( val === false ) {
onready = false;
}
if( val === true || onready === true ) {
setState();
}
return $.route;
},
/**
* Returns a url from the options
* @param {Object} options
* @param {Boolean} merge true if the options should be merged with the current options
* @return {String}
*/
url: function( options, merge ) {
if (merge) {
return "#!" + $.route.param(extend({}, curParams, options))
} else {
return "#!" + $.route.param(options)
}
},
/**
* Returns a link
* @param {Object} name The text of the link.
* @param {Object} options The route options (variables)
* @param {Object} props Properties of the <a> other than href.
* @param {Boolean} merge true if the options should be merged with the current options
*/
link: function( name, options, props, merge ) {
return "<a " + makeProps(
extend({
href: $.route.url(options, merge)
}, props)) + ">" + name + "</a>";
},
/**
* Returns true if the options represent the current page.
* @param {Object} options
* @return {Boolean}
*/
current: function( options ) {
return location.hash == "#!" + $.route.param(options)
}
});
// onready
$(function() {
$.route.ready();
});
// The functions in the following list applied to $.route (e.g. $.route.attr('...')) will
// instead act on the $.route.data Observe.
each(['bind','unbind','delegate','undelegate','attr','attrs','serialize','removeAttr'], function(i, name){
$.route[name] = function(){
return $.route.data[name].apply($.route.data, arguments)
}
})
var // A throttled function called multiple times will only fire once the
// timer runs down. Each call resets the timer.
throttle = function( func ) {
var timer;
return function() {
var args = arguments,
self = this;
clearTimeout(timer);
timer = setTimeout(function(){
func.apply(self, args)
}, 1);
}
},
// Intermediate storage for $.route.data.
curParams,
// Deparameterizes the portion of the hash of interest and assign the
// values to the $.route.data removing existing values no longer in the hash.
setState = function() {
var hash = location.hash.substr(1, 1) === '!' ?
location.hash.slice(2) :
location.hash.slice(1); // everything after #!
curParams = $.route.deparam( hash );
$.route.attrs(curParams, true);
};
// If the hash changes, update the $.route.data
$(window).bind('hashchange', setState);
// If the $.route.data changes, update the hash.
// Using .serialize() retrieves the raw data contained in the observable.
// This function is throttled so it only updates once even if multiple values changed.
$.route.bind("change", throttle(function() {
location.hash = "#!" + $.route.param($.route.serialize())
}));
})