diff options
author | Chris Rebert <code@rebertia.com> | 2015-02-05 08:03:10 +0300 |
---|---|---|
committer | Chris Rebert <code@rebertia.com> | 2015-02-05 08:03:10 +0300 |
commit | 9cceebc981f7aaae96ad0a1033e948c0dc9b27ab (patch) | |
tree | 50b36ae28d54c888672542bd930c4e0c228dc2e4 /dist/cjs/mq4-hover-shim.js | |
parent | b527c5bdb2033c42eaeef36ddd0bd03c0ca655de (diff) |
rename & move package: cvrebert/mq4-hover-hover-shim => twbs/mq4-hover-shimv0.1.0
Diffstat (limited to 'dist/cjs/mq4-hover-shim.js')
-rw-r--r-- | dist/cjs/mq4-hover-shim.js | 135 |
1 files changed, 135 insertions, 0 deletions
diff --git a/dist/cjs/mq4-hover-shim.js b/dist/cjs/mq4-hover-shim.js new file mode 100644 index 0000000..4ea9bfe --- /dev/null +++ b/dist/cjs/mq4-hover-shim.js @@ -0,0 +1,135 @@ +"use strict"; + +var _interopRequireWildcard = function (obj) { return obj && obj.__esModule ? obj : { "default": obj }; }; + + + + +/** +* Does this UA's primary pointer support true hovering +* OR does the UA at least not try to quirkily emulate hovering, +* such that :hover CSS styles are appropriate? +* Essentially tries to shim the `@media (hover: hover)` CSS media query feature. +* @public +* @returns {boolean} +* @since 0.0.1 +*/ +exports.supportsTrueHover = supportsTrueHover; +/*eslint-env browser */ +/*eslint no-var:2*/ +/* jshint browser: true, esnext: true */ +/* jshint -W080 */ +/** +* @module mq4HoverShim +* @requires jquery +*/ +var $ = (function () { + try { + var jQuery = _interopRequireWildcard(require("jquery")); + + return jQuery; + } catch (importErr) { + var globaljQuery = window.$ || window.jQuery || window.Zepto; + if (!globaljQuery) { + throw new Error("mq4HoverShim needs jQuery (or similar)"); + } + return globaljQuery; + } +})(); + +/** @type {boolean|undefined} */ +var canTrulyHover = undefined; + +/** +* @private +* @fires mq4HoverShim#mq4hsChange +*/ +function triggerEvent() { + $(document).trigger($.Event("mq4hsChange", { bubbles: false, trueHover: canTrulyHover })); +} + +// IIFE so we can use `return`s to avoid deeply-nested if-s +(function () { + if (!window.matchMedia) { + // Opera Mini, IE<=9, Android<=2.3, ancient, or obscure; per http://caniuse.com/#feat=matchmedia + + // Opera Mini, Android, and IE Mobile don't support true hovering, so they're what we'll check for. + // Other browsers are either: + // (a) obscure + // (b) touch-based but old enough not to attempt to emulate hovering + // (c) old desktop browsers that do support true hovering + + // Explanation of this UA regex: + // IE Mobile <9 seems to always have "Windows CE", "Windows Phone", or "IEMobile" in its UA string. + // IE Mobile 9 in desktop view doesn't include "IEMobile" or "Windows Phone" in the UA string, + // but it instead includes "XBLWP7" and/or "ZuneWP7". + canTrulyHover = !/Opera Mini|Android|IEMobile|Windows (Phone|CE)|(XBL|Zune)WP7/.test(navigator.userAgent); + + // Since there won't be any event handlers to fire our events, do the one-and-only firing of it here and now. + triggerEvent(); + return; + } + + // CSSWG Media Queries Level 4 draft + // http://drafts.csswg.org/mediaqueries/#hover + var HOVER_NONE = "(hover: none),(-moz-hover: none),(-ms-hover: none),(-webkit-hover: none)"; + var HOVER_ON_DEMAND = "(hover: on-demand),(-moz-hover: on-demand),(-ms-hover: on-demand),(-webkit-hover: on-demand)"; + var HOVER_HOVER = "(hover: hover),(-moz-hover: hover),(-ms-hover: hover),(-webkit-hover: hover)"; + if (window.matchMedia("" + HOVER_NONE + "," + HOVER_ON_DEMAND + "," + HOVER_HOVER).matches) { + // Browser understands the `hover` media feature + var hoverCallback = function (mql) { + var doesMatch = mql.matches; + if (doesMatch !== canTrulyHover) { + canTrulyHover = doesMatch; + triggerEvent(); + } + }; + var atHoverQuery = window.matchMedia(HOVER_HOVER); + atHoverQuery.addListener(hoverCallback); + hoverCallback(atHoverQuery); + return; + } + + // Check for touch support instead. + // Touch generally implies that hovering is merely emulated, + // which doesn't count as true hovering support for our purposes + // due to the quirkiness of the emulation (e.g. :hover being sticky). + + // W3C Pointer Events PR, 16 December 2014 + // http://www.w3.org/TR/2014/PR-pointerevents-20141216/ + // Prefixed in IE10, per http://caniuse.com/#feat=pointer + if (window.PointerEvent || window.MSPointerEvent) { + // Browser supports Pointer Events + + // Browser supports touch if it has touch points + /* jshint -W018 */ + canTrulyHover = !((window.navigator.maxTouchPoints || window.navigator.msMaxTouchPoints) > 0); + /* jshint +W018 */ + triggerEvent(); + return; + } + + // Mozilla's -moz-touch-enabled + // https://developer.mozilla.org/en-US/docs/Web/Guide/CSS/Media_queries#-moz-touch-enabled + var touchEnabledQuery = window.matchMedia("(touch-enabled),(-moz-touch-enabled),(-ms-touch-enabled),(-webkit-touch-enabled)"); + if (touchEnabledQuery.matches) { + canTrulyHover = false; + triggerEvent(); + return; + } + + // W3C Touch Events REC, 10 October 2013 + // http://www.w3.org/TR/2013/REC-touch-events-20131010/ + if ("ontouchstart" in window) { + canTrulyHover = false; + triggerEvent(); + return; + } + + // UA's pointer is non-touch and thus likely either supports true hovering or at least does not try to emulate it. + canTrulyHover = true; + triggerEvent(); +})();function supportsTrueHover() { + return canTrulyHover; +} +exports.__esModule = true;
\ No newline at end of file |