third_party/polymer/v1_0/components-chromium/more-routing/routing-extracted.js

   1 (function(scope) {
   2 var MoreRouting = scope.MoreRouting = scope.MoreRouting || {};
   3
   4 // Route singletons.
   5 var routesByPath = {};
   6 var pathsByName  = {};
   7
   8 // Route Management
   9
  10 /**
  11  * Retrieves (or builds) the singleton `Route` for the given path expression or
  12  * route name.
  13  *
  14  * Paths begin with `/`; anything else is considered a name.
  15  *
  16  * For convenience, `Route` objects can also be passed (and will be returned) -
  17  * this can be used as a route coercion function.
  18  *
  19  * @param {String|MoreRouting.Route} pathOrName
  20  * @param {MoreRouting.Route} parent
  21  * @return {MoreRouting.Route}
  22  */
  23 MoreRouting.getRoute = function getRoute(pathOrName, parent) {
  24   if (typeof pathOrName !== 'string') return pathOrName;
  25   if (this.isPath(pathOrName)) {
  26     return this.getRouteByPath(pathOrName, parent);
  27   } else {
  28     return this.getRouteByName(pathOrName);
  29   }
  30 }
  31
  32 /**
  33  * Retrieves (or builds) the singleton `Route` for the given path expression.
  34  *
  35  * @param {String} path
  36  * @param {MoreRouting.Route} parent
  37  * @return {MoreRouting.Route}
  38  */
  39 MoreRouting.getRouteByPath = function getRouteByPath(path, parent) {
  40   var fullPath = (parent ? parent.fullPath : '') + path;
  41   if (!routesByPath[fullPath]) {
  42     routesByPath[fullPath] = new this.Route(path, parent);
  43     this.driver.manageRoute(routesByPath[fullPath]);
  44   }
  45   return routesByPath[fullPath];
  46 }
  47
  48 /**
  49  * Retrieves the route registered via `name`.
  50  *
  51  * @param {String} name
  52  * @return {MoreRouting.Route}
  53  */
  54 MoreRouting.getRouteByName = function getRouteByName(name) {
  55   var path = pathsByName[name];
  56   if (!path) {
  57     throw new Error('No route named "' + name + '" has been registered');
  58   }
  59   return this.getRouteByPath(path);
  60 }
  61
  62 /**
  63  * @param {String} path
  64  * @return {MoreRouting.Route} The newly registered route.
  65  */
  66 MoreRouting.registerNamedRoute = function registerNamedRoute(name, path, parent) {
  67   if (pathsByName[name]) {
  68     console.warn(
  69         'Overwriting route named "' + name + '" with path:', path,
  70         'previously:', pathsByName[name]);
  71   }
  72   var route = this.getRouteByPath(path, parent);
  73   pathsByName[name] = route.fullPath;
  74   return route;
  75 };
  76
  77 // Route Shortcuts
  78 MoreRouting.urlFor = function urlFor(pathOrName, params) {
  79   return this.getRoute(pathOrName).urlFor(params);
  80 };
  81
  82 MoreRouting.navigateTo = function navigateTo(pathOrName, params) {
  83   return this.getRoute(pathOrName).navigateTo(params);
  84 };
  85
  86 MoreRouting.isCurrentUrl = function isCurrentUrl(pathOrName, params) {
  87   return this.getRoute(pathOrName).isCurrentUrl(params);
  88 };
  89
  90 // Utility
  91
  92 /**
  93  *
  94  */
  95 MoreRouting.isPath = function isPath(pathOrName) {
  96   return this.Route.isPath(pathOrName);
  97 }
  98
  99 /**
 100  * @param {...String} paths
 101  */
 102 MoreRouting.joinPath = function joinPath(paths) {
 103   return this.Route.joinPath.apply(this.Route, arguments);
 104 }
 105
 106 // Driver Management
 107
 108 var driver;
 109 Object.defineProperty(MoreRouting, 'driver', {
 110   get: function getDriver() {
 111     if (!driver) {
 112       throw new Error('No routing driver configured. Did you forget <more-routing-config>?');
 113     }
 114     return driver;
 115   },
 116   set: function setDriver(newDriver) {
 117     if (driver) {
 118       console.warn('Changing routing drivers is not supported, ignoring. You should have only one <more-routing-config> on the page!');
 119       return;
 120     }
 121     driver = newDriver;
 122   }
 123 });
 124
 125 })(window);