{ "file": "addon/routes/base-route.js", "content": "
import Route from 'ember-route';\nimport inject from 'ember-service/inject';\nimport { scheduleOnce } from 'ember-runloop';\nimport $ from 'jquery';\n\n/**\n * The Fountainhead base route class contains handlers for targeted scrolling\n * including {{c-l 'resetController'}} (to clear sticky parameters),\n * {{c-l 'crossLinkFragmentOverride'}} (for History consumers using a cross link),\n * and {{c-l 'didTransition'}} (to update application hash tracker).\n * @class BaseRoute\n * @constructor\n * @extends Ember.Route\n */\nexport default Route.extend({\n  fountainhead: inject(),\n\n  // Properties\n  // ---------------------------------------------------------------------------\n  /**\n   * Required for History consumers when cross linking to a different class _(Ember\n   * strips hash from the {{c-l class='FHHref'}} component)_. When a cross link with\n   * a property is clicked, the cross link will set this property to notify the route\n   * that there is a fragment that should be observed on transition.\n   * @property crossLinkFragmentOverride\n   * @type {?string}\n   * @protected\n   * @default null\n   */\n  crossLinkFragmentOverride: null,\n\n  // Hooks\n  // ---------------------------------------------------------------------------\n  /**\n   * We don't want the `id` query param to be sticky. If it is, then if you\n   * have an `id` scroll target for a class, navigate elsewhere and then click that\n   * class again in the `api-nav`, the sticky query param will set the `id` to the\n   * previous scroll target, 😣.\n   *\n   * The `resetController` hook is called anytime a route's model changes or the\n   * route is exited, and is the recommended time to reset query param values on\n   * a controller.\n   * @method resetController\n   * @param {Object}  controller\n   * @param {Boolean} isExiting\n   * @param {Object}  transition\n   */\n  resetController(controller, isExiting, transition) {\n    controller.set('id', null);\n  },\n\n  // Actions\n  // ---------------------------------------------------------------------------\n  actions: {\n    /**\n     * On transition, handle resetting scroll position as well as updating\n     * {{c-l class='Fountainhead'}} service that a transition has occurred so that\n     * the new location can be checked for a scroll target hash.\n     * @event didTransition\n     */\n    didTransition() {\n      const crossLinkFragmentOverride = this.get('crossLinkFragmentOverride');\n      // For all transitions, first scroll back to top, this handles when a user scrolls\n      // down th page and then transitions without making any hash changes. If the url\n      // includes a scroll target it will be passed to a page component and trigger a\n      // scroll event\n      $('.fh-page-in-page-wrapper').scrollTop(0);\n\n      const sendFragment = () => {\n        this.get('fountainhead').send('setFragmentId', location.hash.slice(1) || '');\n      };\n\n      const overrideHash = () => {\n        history.replaceState(null, null, `${location.href}#${crossLinkFragmentOverride}`);\n        sendFragment();\n      };\n\n      if (crossLinkFragmentOverride) {\n        // A cross link was used with a scroll target hash. Ember will strip this\n        // target from the URL. After render, handle overriding hash back to the\n        // original target\n        scheduleOnce('render', this, overrideHash);\n        // Clear out override now that it has been handled\n        this.set('crossLinkFragmentOverride', null);\n      } else {\n        // hashChange event does not fire on transitions, after render the URL will\n        // be updated to new location. Send update to Fountainhead service notifying\n        // change event\n        scheduleOnce('render', this, sendFragment);\n      }\n    }\n  }\n});\n
" }