govuk_frontend_toolkit 0.41.1

data/app/assets/javascripts/govuk/multivariate-test.js

@@ -0,0 +1,101 @@
+(function() {
+  "use strict";
+  window.GOVUK = window.GOVUK || {};
+  var $ = window.$;
+
+  // A multivariate test framework
+  //
+  // Based loosely on https://github.com/jamesyu/cohorts
+  //
+  // Full documentation is in README.md.
+  //
+  function MultivariateTest(options) {
+    this.$el = $(options.el);
+    this._loadOption(options, 'name');
+    this._loadOption(options, 'customVarIndex');
+    this._loadOption(options, 'cohorts');
+    this._loadOption(options, 'runImmediately', true);
+
+    if (this.runImmediately) {
+      this.run();
+    }
+  }
+
+  MultivariateTest.prototype._loadOption = function(options, key, defaultValue) {
+    if (options[key] !== undefined) {
+      this[key] = options[key];
+    }
+    if (this[key] === undefined) {
+      if (defaultValue === undefined) {
+        throw new Error(key+" option is required for a multivariate test");
+      }
+      else {
+        this[key] = defaultValue;
+      }
+    }
+  };
+
+  MultivariateTest.prototype.run = function() {
+    var cohort = this.getCohort();
+    if (cohort) {
+      this.setCustomVar(cohort);
+      this.executeCohort(cohort);
+    }
+  };
+
+  MultivariateTest.prototype.executeCohort = function(cohort) {
+    var cohortObj = this.cohorts[cohort];
+    if (cohortObj.callback) {
+      if (typeof cohortObj.callback === "string") {
+        this[cohortObj.callback]();
+      }
+      else {
+        cohortObj.callback();
+      }
+    }
+    if (cohortObj.html) {
+      this.$el.html(cohortObj.html);
+      this.$el.show();
+    }
+  };
+
+  // Get the current cohort or assign one if it has not been already
+  MultivariateTest.prototype.getCohort = function() {
+    var cohort = GOVUK.cookie(this.cookieName());
+    if (!cohort || !this.cohorts[cohort]) {
+      cohort = this.chooseRandomCohort();
+      GOVUK.cookie(this.cookieName(), cohort, {days: 30});
+    }
+    return cohort;
+  };
+
+  MultivariateTest.prototype.setCustomVar = function(cohort) {
+    window._gaq = window._gaq || [];
+    window._gaq.push([
+      '_setCustomVar',
+      this.customVarIndex,
+      this.cookieName(),
+      cohort,
+      2 // session level
+    ]);
+    // Fire off a dummy event to set the custom var on the page.
+    // Ideally we'd be able to call setCustomVar before trackPageview,
+    // but would need reordering the existing GA code.
+    window._gaq.push(['_trackEvent', this.cookieName(), 'run', '-', 0, true]);
+  };
+
+  MultivariateTest.prototype.cohortNames = function() {
+    return $.map(this.cohorts, function(v, i) { return i; });
+  };
+
+  MultivariateTest.prototype.chooseRandomCohort = function() {
+    var names = this.cohortNames();
+    return names[Math.floor(Math.random() * names.length)];
+  };
+
+  MultivariateTest.prototype.cookieName = function() {
+    return "multivariatetest_cohort_" + this.name;
+  };
+
+  window.GOVUK.MultivariateTest = MultivariateTest;
+}());

data/app/assets/javascripts/govuk/stop-scrolling-at-footer.js

@@ -0,0 +1,138 @@
+// Stop scrolling at footer.
+//
+// This can be added to elements with `position: fixed` to stop them from
+// overflowing on the footer.
+//
+// Usage:
+//
+//    GOVUK.stopScrollingAtFooter.addEl($(node), $(node).height());
+//
+// Height is passed in separatly incase the scrolling element has no height
+// itself.
+
+
+(function () {
+  "use strict"
+  var root = this,
+      $ = root.jQuery;
+  if(typeof root.GOVUK === 'undefined') { root.GOVUK = {}; }
+
+  var stopScrollingAtFooter = {
+    _pollingId: null,
+    _isPolling: false,
+    _hasScrollEvt: false,
+    _els: [],
+
+    addEl: function($fixedEl, height){
+      var fixedOffset;
+
+      if(!$fixedEl.length) { return; }
+
+      fixedOffset = parseInt($fixedEl.css('top'), 10);
+      fixedOffset = isNaN(fixedOffset) ? 0 : fixedOffset;
+
+      stopScrollingAtFooter.updateFooterTop();
+      $(root).on('govuk.pageSizeChanged', stopScrollingAtFooter.updateFooterTop);
+
+      var $siblingEl = $('<div></div>');
+      $siblingEl.insertBefore($fixedEl);
+      var fixedTop = $siblingEl.offset().top - $siblingEl.position().top;
+      $siblingEl.remove();
+
+      var el = {
+        $fixedEl: $fixedEl,
+        height: height + fixedOffset,
+        fixedTop: height + fixedTop,
+        state: 'fixed'
+      };
+      stopScrollingAtFooter._els.push(el);
+
+      stopScrollingAtFooter.initTimeout();
+    },
+    updateFooterTop: function(){
+      var footer = $('.js-footer:eq(0)');
+      if (footer.length === 0) {
+        return 0;
+      }
+      stopScrollingAtFooter.footerTop = footer.offset().top - 10;
+    },
+    initTimeout: function(){
+      if(stopScrollingAtFooter._hasScrollEvt === false) {
+        $(window).scroll(stopScrollingAtFooter.onScroll);
+        stopScrollingAtFooter._hasScrollEvt = true;
+      }
+    },
+    onScroll: function(){
+      if (stopScrollingAtFooter._isPolling === false) { 
+        stopScrollingAtFooter.startPolling();
+      }
+    },
+    startPolling: (function(){
+      if (window.requestAnimationFrame) {
+        return (function(){
+          var callback = function(){
+            stopScrollingAtFooter.checkScroll();
+            if (stopScrollingAtFooter._isPolling === true) {
+              stopScrollingAtFooter.startPolling();
+            }
+          };
+          stopScrollingAtFooter._pollingId = window.requestAnimationFrame(callback);
+          stopScrollingAtFooter._isPolling = true;
+        });
+      } else {
+        return (function(){
+          stopScrollingAtFooter._pollingId = window.setInterval(stopScrollingAtFooter.checkScroll, 16);
+          stopScrollingAtFooter._isPolling = true;
+        });
+      }
+    }()),
+    stopPolling: (function(){
+      if (window.requestAnimationFrame) {
+        return (function(){
+          window.cancelAnimationFrame(stopScrollingAtFooter._pollingId);
+          stopScrollingAtFooter._isPolling = false;
+        });
+      } else {
+        return (function(){
+          window.clearInterval(stopScrollingAtFooter._pollingId);
+          stopScrollingAtFooter._isPolling = false;
+        });
+      }
+    }()),
+    checkScroll: function(){
+      var cachedScrollTop = $(window).scrollTop();
+      if ((cachedScrollTop < (stopScrollingAtFooter.cachedScrollTop + 2)) && (cachedScrollTop > (stopScrollingAtFooter.cachedScrollTop - 2))) {
+        stopScrollingAtFooter.stopPolling();
+        return;
+      } else {
+        stopScrollingAtFooter.cachedScrollTop = cachedScrollTop;
+      }
+
+      $.each(stopScrollingAtFooter._els, function(i, el){
+        var bottomOfEl = cachedScrollTop + el.height;
+
+        if (bottomOfEl > stopScrollingAtFooter.footerTop){
+          stopScrollingAtFooter.stick(el);
+        } else {
+          stopScrollingAtFooter.unstick(el);
+        }
+      });
+    },
+    stick: function(el){
+      if(el.state === 'fixed' && el.$fixedEl.css('position') === 'fixed'){
+        el.$fixedEl.css({ 'position': 'absolute', 'top': stopScrollingAtFooter.footerTop - el.fixedTop });
+        el.state = 'absolute';
+      }
+    },
+    unstick: function(el){
+      if(el.state === 'absolute'){
+        el.$fixedEl.css({ 'position': '', 'top': '' });
+        el.state = 'fixed';
+      }
+    }
+  };
+
+  root.GOVUK.stopScrollingAtFooter = stopScrollingAtFooter;
+
+  $(root).load(function(){ $(root).trigger('govuk.pageSizeChanged'); });
+}).call(this);