( function ( $, mw ) { /** * @class mw.popups.render * @singleton */ mw.popups.render = {}; /** * Time to wait in ms before showing a popup on hover * @property POPUP_DELAY */ mw.popups.render.POPUP_DELAY = 150; /** * Time to wait in ms before closing a popup on de-hover * @property POPUP_CLOSE_DELAY */ mw.popups.render.POPUP_CLOSE_DELAY = 100; /** * Time to wait in ms before starting the API queries on hover, must be <= POPUP_DELAY * @property API_DELAY */ mw.popups.render.API_DELAY = 50; /** * Cache of all the popups that were opened in this session * @property {Object} cache */ mw.popups.render.cache = {}; /** * The timer used to delay `closePopups` * @property {jQuery.Deferred} closeTimer */ mw.popups.render.closeTimer = undefined; /** * The timer used to delay sending the API request/opening the popup form cache * @property {jQuery.Deferred} openTimer */ mw.popups.render.openTimer = undefined; /** * The link the currently has a popup * @property {jQuery} currentLink */ mw.popups.render.currentLink = undefined; /** * Current API request * @property {jQuery.Deferred} currentRequest */ mw.popups.render.currentRequest = undefined; /** * Close all other popups and render the new one from the cache * or by finding and calling the correct renderer * * @method render * @param {Object} link * @param {Object} event */ mw.popups.render.render = function ( link, event ) { // This will happen when the mouse goes from the popup box back to the // anchor tag. In such a case, the timer to close the box is cleared. if ( mw.popups.render.currentLink === link ) { mw.popups.render.closeTimer.abort(); return; } // If the mouse moves to another link (we already check if its the same // link in the previous condition), then close the popup. if ( mw.popups.render.currentLink ) { mw.popups.render.closePopup(); } // Ignore if its meant to call a function // TODO: Remove this when adding reference popups if ( link.attr( 'href' ) === '#' ) { return; } mw.popups.render.currentLink = link; link.on( 'mouseleave blur', mw.popups.render.leaveInactive ); if ( mw.popups.render.cache[ link.attr( 'href' ) ] ) { mw.popups.render.openTimer = mw.popups.render.wait( mw.popups.render.POPUP_DELAY ) .done( function () { mw.popups.render.openPopup( link, event ); } ); } else { // TODO: check for link type and call correct renderer // There is only one popup type so it isn't necessary right now var cachePopup = mw.popups.render.article.init( link ); mw.popups.render.openTimer = mw.popups.render.wait( mw.popups.render.API_DELAY ) .done( function () { mw.popups.render.openTimer = mw.popups.render.wait( mw.popups.render.POPUP_DELAY - mw.popups.render.API_DELAY ); $.when( mw.popups.render.openTimer, cachePopup ).done( function () { mw.popups.render.openPopup( link, event ); } ); } ); } }; /** * Retrieves the popup from the cache, uses its offset function * applied classes and calls the process function. * Takes care of event logging and attaching other events. * * @method openPopup * @param {Object} link * @param {Object} event */ mw.popups.render.openPopup = function ( link, event ) { var cache = mw.popups.render.cache [ link.attr( 'href' ) ], popup = cache.popup, offset = cache.getOffset( link, event ), classes = cache.getClasses( link ); mw.popups.$popup .html( '' ) .attr( 'class', 'mwe-popups' ) .addClass( classes.join( ' ' ) ) .css( offset ) .append( popup ) .show() .attr( 'aria-hidden', 'false' ) .addClass( 'mwe-popups-fade-in' ) .on( 'mouseleave', mw.popups.render.leaveActive ) .on( 'mouseenter', function () { if ( mw.popups.render.closeTimer ) { mw.popups.render.closeTimer.abort(); } } ); // Hack to 'refresh' the SVG and thus display it // Elements get added to the DOM and not to the screen because of different namespaces of HTML and SVG // More information and workarounds here - http://stackoverflow.com/a/13654655/366138 mw.popups.$popup.html( mw.popups.$popup.html() ); cache.process( link ); // Event logging mw.popups.eventLogging.time = mw.now(); mw.popups.eventLogging.action = 'dismissed'; link .off( 'mouseleave blur', mw.popups.render.leaveInactive ) .on( 'mouseleave blur', mw.popups.render.leaveActive ); $( document ).on( 'keydown', mw.popups.render.closeOnEsc ); }; /** * Removes the hover class from the link and unbinds events * Hides the popup, clears timers and sets it and the resets the renderer * * @method closePopup */ mw.popups.render.closePopup = function () { mw.popups.eventLogging.duration = mw.now() - mw.popups.eventLogging.time; $( mw.popups.render.currentLink ).off( 'mouseleave blur', mw.popups.render.leaveActive ); mw.popups.$popup .removeClass( 'mwe-popups-fade-in' ) .addClass( 'mwe-popups-fade-out' ); mw.popups.render.wait( 150 ).done( function () { if ( mw.popups.$popup.hasClass( 'mwe-popups-fade-out' ) ) { mw.popups.$popup .attr( 'aria-hidden', 'true' ) .hide() .removeClass( 'mwe-popups-fade-out' ); } } ); if ( mw.popups.render.closeTimer ) { mw.popups.render.closeTimer.abort(); } $( document ).off( 'keydown', mw.popups.render.closeOnEsc ); mw.popups.render.reset(); }; /** * Return a promise corresponding to a `setTimeout()` call. Call `.abort()` on the return value * to perform the equivalent of `clearTimeout()` * * @method wait * @param {Number} ms Milliseconds to wait * @return {jQuery.Promise} */ mw.popups.render.wait = function ( ms ) { var deferred, promise, timeout; deferred = $.Deferred(); timeout = setTimeout( function () { deferred.resolve(); }, ms ); promise = deferred.promise( { abort: function () { clearTimeout( timeout ); deferred.reject(); } } ); return promise; }; /** * Use escape to close popup * * @method closeOnEsc */ mw.popups.render.closeOnEsc = function ( event ) { if ( event.keyCode === 27 ) { mw.popups.render.closePopup(); } }; /** * Closes the box after a delay * Delay to give enough time for the user to move the pointer from * the link to the popup box. Also avoids closing the popup by accident * * @method leaveActive */ mw.popups.render.leaveActive = function () { mw.popups.render.closeTimer = mw.popups.render.wait( mw.popups.render.POPUP_CLOSE_DELAY ).done( function () { mw.popups.render.closePopup(); } ); }; /** * Unbinds events on the anchor tag and aborts AJAX request. * * @method leaveInactive */ mw.popups.render.leaveInactive = function () { $( mw.popups.render.currentLink ).off( 'mouseleave', mw.popups.render.leaveInactive ); if ( mw.popups.render.openTimer ) { mw.popups.render.openTimer.abort(); } if ( mw.popups.render.currentRequest ) { mw.popups.render.currentRequest.abort(); } mw.popups.render.reset(); }; /** * Resets the renderer * * @method reset */ mw.popups.render.reset = function () { mw.popups.render.currentLink = undefined; mw.popups.render.currentRequest = undefined; mw.popups.render.openTimer = undefined; mw.popups.render.closeTimer = undefined; }; } ) ( jQuery, mediaWiki );