fix previous slide navigation logic (closes #397)
[reveal.js.git] / js / reveal.js
index 93b14f7e451727a20f4b24ed021842133c12651f..516d114e83d2c950da5e42c3a0a4f281aeb2593c 100644 (file)
@@ -3,7 +3,7 @@
  * http://lab.hakim.se/reveal-js
  * MIT licensed
  *
- * Copyright (C) 2011-2012 Hakim El Hattab, http://hakim.se
+ * Copyright (C) 2013 Hakim El Hattab, http://hakim.se
  */
 var Reveal = (function(){
 
@@ -16,6 +16,19 @@ var Reveal = (function(){
 
                // Configurations defaults, can be overridden at initialization time
                config = {
+
+                       // The "normal" size of the presentation, aspect ratio will be preserved
+                       // when the presentation is scaled to fit different resolutions
+                       width: 960,
+                       height: 700,
+
+                       // Factor of the display size that should remain empty around the content
+                       margin: 0.1,
+
+                       // Bounds for smallest/largest possible scale to apply to content
+                       minScale: 0.2,
+                       maxScale: 1.0,
+
                        // Display controls in the bottom right corner
                        controls: true,
 
@@ -31,7 +44,7 @@ var Reveal = (function(){
                        // Enable the slide overview mode
                        overview: true,
 
-                       // Vertical centering of slides
+                       // Vertical centring of slides
                        center: true,
 
                        // Enables touch navigation on devices with touch input
@@ -60,15 +73,17 @@ var Reveal = (function(){
                        // Transition style
                        transition: 'default', // default/cube/page/concave/zoom/linear/fade/none
 
+                       // Transition speed
+                       transitionSpeed: 'default', // default/fast/slow
+
                        // Script dependencies to load
                        dependencies: []
                },
 
-               // Stores if the next slide should be shown automatically
-               // after n milliseconds
-               autoSlide = config.autoSlide,
+               // The current auto-slide duration
+               autoSlide = 0,
 
-               // The horizontal and verical index of the currently active slide
+               // The horizontal and vertical index of the currently active slide
                indexh = 0,
                indexv = 0,
 
@@ -81,6 +96,9 @@ var Reveal = (function(){
                // all current slides.
                state = [],
 
+               // The current scale of the presentation (see width/height config)
+               scale = 1,
+
                // Cached references to DOM elements
                dom = {},
 
@@ -113,6 +131,9 @@ var Reveal = (function(){
                // A delay used to deactivate the overview mode
                deactivateOverviewTimeout = 0,
 
+               // Flags if the interaction event listeners are bound
+               eventsAreBound = false,
+
                // Holds information about the currently ongoing touch input
                touch = {
                        startX: 0,
@@ -128,7 +149,7 @@ var Reveal = (function(){
         */
        function initialize( options ) {
 
-               if( ( !supports2DTransforms && !supports3DTransforms ) ) {
+               if( !supports2DTransforms && !supports3DTransforms ) {
                        document.body.setAttribute( 'class', 'no-transforms' );
 
                        // If the browser doesn't support core features we won't be
@@ -163,7 +184,7 @@ var Reveal = (function(){
                dom.slides = document.querySelector( '.reveal .slides' );
 
                // Progress bar
-               if( !dom.wrapper.querySelector( '.progress' ) && config.progress ) {
+               if( !dom.wrapper.querySelector( '.progress' ) ) {
                        var progressElement = document.createElement( 'div' );
                        progressElement.classList.add( 'progress' );
                        progressElement.innerHTML = '<span></span>';
@@ -171,7 +192,7 @@ var Reveal = (function(){
                }
 
                // Arrow controls
-               if( !dom.wrapper.querySelector( '.controls' ) && config.controls ) {
+               if( !dom.wrapper.querySelector( '.controls' ) ) {
                        var controlsElement = document.createElement( 'aside' );
                        controlsElement.classList.add( 'controls' );
                        controlsElement.innerHTML = '<div class="navigate-left"></div>' +
@@ -218,11 +239,7 @@ var Reveal = (function(){
         */
        function hideAddressBar() {
 
-               if( navigator.userAgent.match( /(iphone|ipod)/i ) ) {
-                       // Give the page some scrollable overflow
-                       document.documentElement.style.overflow = 'scroll';
-                       document.body.style.height = '120%';
-
+               if( /iphone|ipod|android/gi.test( navigator.userAgent ) && !/crios/gi.test( navigator.userAgent ) ) {
                        // Events that should trigger the address bar to hide
                        window.addEventListener( 'load', removeAddressBar, false );
                        window.addEventListener( 'orientationchange', removeAddressBar, false );
@@ -261,7 +278,7 @@ var Reveal = (function(){
                        }
                }
 
-               // Called once synchronous scritps finish loading
+               // Called once synchronous scripts finish loading
                function proceed() {
                        if( scriptsAsync.length ) {
                                // Load asynchronous scripts
@@ -292,22 +309,12 @@ var Reveal = (function(){
                // Make sure we've got all the DOM elements we need
                setupDOM();
 
-               // Subscribe to input
-               addEventListeners();
-
                // Updates the presentation to match the current configuration values
                configure();
 
-               // Force an initial layout, will thereafter be invoked as the window
-               // is resized
-               layout();
-
                // Read the initial hash
                readURL();
 
-               // Start auto-sliding if it's enabled
-               cueAutoSlide();
-
                // Notify listeners that the presentation is ready but use a 1ms
                // timeout to ensure it's not fired synchronously after #initialize()
                setTimeout( function() {
@@ -323,40 +330,58 @@ var Reveal = (function(){
        /**
         * Applies the configuration settings from the config object.
         */
-       function configure() {
+       function configure( options ) {
 
-               if( supports3DTransforms === false ) {
-                       config.transition = 'linear';
-               }
+               dom.wrapper.classList.remove( config.transition );
 
-               if( config.controls && dom.controls ) {
-                       dom.controls.style.display = 'block';
-               }
+               // New config options may be passed when this method
+               // is invoked through the API after initialization
+               if( typeof options === 'object' ) extend( config, options );
 
-               if( config.progress && dom.progress ) {
-                       dom.progress.style.display = 'block';
+               // Force linear transition based on browser capabilities
+               if( supports3DTransforms === false ) config.transition = 'linear';
+
+               dom.wrapper.classList.add( config.transition );
+
+               dom.wrapper.setAttribute( 'data-transition-speed', config.transitionSpeed );
+
+               if( dom.controls ) {
+                       dom.controls.style.display = ( config.controls && dom.controls ) ? 'block' : 'none';
                }
 
-               if( config.transition !== 'default' ) {
-                       dom.wrapper.classList.add( config.transition );
+               if( dom.progress ) {
+                       dom.progress.style.display = ( config.progress && dom.progress ) ? 'block' : 'none';
                }
 
                if( config.rtl ) {
                        dom.wrapper.classList.add( 'rtl' );
                }
+               else {
+                       dom.wrapper.classList.remove( 'rtl' );
+               }
 
                if( config.center ) {
                        dom.wrapper.classList.add( 'center' );
                }
+               else {
+                       dom.wrapper.classList.remove( 'center' );
+               }
 
                if( config.mouseWheel ) {
                        document.addEventListener( 'DOMMouseScroll', onDocumentMouseScroll, false ); // FF
                        document.addEventListener( 'mousewheel', onDocumentMouseScroll, false );
                }
+               else {
+                       document.removeEventListener( 'DOMMouseScroll', onDocumentMouseScroll, false ); // FF
+                       document.removeEventListener( 'mousewheel', onDocumentMouseScroll, false );
+               }
 
                // 3D links
                if( config.rollingLinks ) {
-                       linkify();
+                       enable3DLinks();
+               }
+               else {
+                       disable3DLinks();
                }
 
                // Load the theme in the config, if it's not already loaded
@@ -371,6 +396,29 @@ var Reveal = (function(){
                        }
                }
 
+               postConfigure();
+
+       }
+
+       /**
+        * Updates various parts of the presentatio after the
+        * configuration has changed.
+        */
+       function postConfigure() {
+
+               // Subscribe to input
+               removeEventListeners();
+               addEventListeners();
+
+               // Force a layout to make sure the current config is accounted for
+               layout();
+
+               // Reflect the current autoSlide value
+               autoSlide = config.autoSlide;
+
+               // Start auto-sliding if it's enabled
+               cueAutoSlide();
+
        }
 
        /**
@@ -378,13 +426,22 @@ var Reveal = (function(){
         */
        function addEventListeners() {
 
+               eventsAreBound = true;
+
                window.addEventListener( 'hashchange', onWindowHashChange, false );
                window.addEventListener( 'resize', onWindowResize, false );
 
                if( config.touch ) {
-                       document.addEventListener( 'touchstart', onDocumentTouchStart, false );
-                       document.addEventListener( 'touchmove', onDocumentTouchMove, false );
-                       document.addEventListener( 'touchend', onDocumentTouchEnd, false );
+                       dom.wrapper.addEventListener( 'touchstart', onTouchStart, false );
+                       dom.wrapper.addEventListener( 'touchmove', onTouchMove, false );
+                       dom.wrapper.addEventListener( 'touchend', onTouchEnd, false );
+
+                       // Support pointer-style touch interaction as well
+                       if( window.navigator.msPointerEnabled ) {
+                               dom.wrapper.addEventListener( 'MSPointerDown', onPointerDown, false );
+                               dom.wrapper.addEventListener( 'MSPointerMove', onPointerMove, false );
+                               dom.wrapper.addEventListener( 'MSPointerUp', onPointerUp, false );
+                       }
                }
 
                if( config.keyboard ) {
@@ -392,17 +449,18 @@ var Reveal = (function(){
                }
 
                if ( config.progress && dom.progress ) {
-                       dom.progress.addEventListener( 'click', preventAndForward( onProgressClick ), false );
+                       dom.progress.addEventListener( 'click', onProgressClicked, false );
                }
 
                if ( config.controls && dom.controls ) {
-                       var actionEvent = 'ontouchstart' in window ? 'touchstart' : 'click';
-                       dom.controlsLeft.forEach( function( el ) { el.addEventListener( actionEvent, preventAndForward( navigateLeft ), false ); } );
-                       dom.controlsRight.forEach( function( el ) { el.addEventListener( actionEvent, preventAndForward( navigateRight ), false ); } );
-                       dom.controlsUp.forEach( function( el ) { el.addEventListener( actionEvent, preventAndForward( navigateUp ), false ); } );
-                       dom.controlsDown.forEach( function( el ) { el.addEventListener( actionEvent, preventAndForward( navigateDown ), false ); } );
-                       dom.controlsPrev.forEach( function( el ) { el.addEventListener( actionEvent, preventAndForward( navigatePrev ), false ); } );
-                       dom.controlsNext.forEach( function( el ) { el.addEventListener( actionEvent, preventAndForward( navigateNext ), false ); } );
+                       [ 'touchstart', 'click' ].forEach( function( eventName ) {
+                               dom.controlsLeft.forEach( function( el ) { el.addEventListener( eventName, onNavigateLeftClicked, false ); } );
+                               dom.controlsRight.forEach( function( el ) { el.addEventListener( eventName, onNavigateRightClicked, false ); } );
+                               dom.controlsUp.forEach( function( el ) { el.addEventListener( eventName, onNavigateUpClicked, false ); } );
+                               dom.controlsDown.forEach( function( el ) { el.addEventListener( eventName, onNavigateDownClicked, false ); } );
+                               dom.controlsPrev.forEach( function( el ) { el.addEventListener( eventName, onNavigatePrevClicked, false ); } );
+                               dom.controlsNext.forEach( function( el ) { el.addEventListener( eventName, onNavigateNextClicked, false ); } );
+                       } );
                }
 
        }
@@ -412,28 +470,35 @@ var Reveal = (function(){
         */
        function removeEventListeners() {
 
+               eventsAreBound = false;
+
                document.removeEventListener( 'keydown', onDocumentKeyDown, false );
                window.removeEventListener( 'hashchange', onWindowHashChange, false );
                window.removeEventListener( 'resize', onWindowResize, false );
 
-               if( config.touch ) {
-                       document.removeEventListener( 'touchstart', onDocumentTouchStart, false );
-                       document.removeEventListener( 'touchmove', onDocumentTouchMove, false );
-                       document.removeEventListener( 'touchend', onDocumentTouchEnd, false );
+               dom.wrapper.removeEventListener( 'touchstart', onTouchStart, false );
+               dom.wrapper.removeEventListener( 'touchmove', onTouchMove, false );
+               dom.wrapper.removeEventListener( 'touchend', onTouchEnd, false );
+
+               if( window.navigator.msPointerEnabled ) {
+                       dom.wrapper.removeEventListener( 'MSPointerDown', onPointerDown, false );
+                       dom.wrapper.removeEventListener( 'MSPointerMove', onPointerMove, false );
+                       dom.wrapper.removeEventListener( 'MSPointerUp', onPointerUp, false );
                }
 
                if ( config.progress && dom.progress ) {
-                       dom.progress.removeEventListener( 'click', preventAndForward( onProgressClick ), false );
+                       dom.progress.removeEventListener( 'click', onProgressClicked, false );
                }
 
                if ( config.controls && dom.controls ) {
-                       var actionEvent = 'ontouchstart' in window ? 'touchstart' : 'click';
-                       dom.controlsLeft.forEach( function( el ) { el.removeEventListener( actionEvent, preventAndForward( navigateLeft ), false ); } );
-                       dom.controlsRight.forEach( function( el ) { el.removeEventListener( actionEvent, preventAndForward( navigateRight ), false ); } );
-                       dom.controlsUp.forEach( function( el ) { el.removeEventListener( actionEvent, preventAndForward( navigateUp ), false ); } );
-                       dom.controlsDown.forEach( function( el ) { el.removeEventListener( actionEvent, preventAndForward( navigateDown ), false ); } );
-                       dom.controlsPrev.forEach( function( el ) { el.removeEventListener( actionEvent, preventAndForward( navigatePrev ), false ); } );
-                       dom.controlsNext.forEach( function( el ) { el.removeEventListener( actionEvent, preventAndForward( navigateNext ), false ); } );
+                       [ 'touchstart', 'click' ].forEach( function( eventName ) {
+                               dom.controlsLeft.forEach( function( el ) { el.removeEventListener( eventName, onNavigateLeftClicked, false ); } );
+                               dom.controlsRight.forEach( function( el ) { el.removeEventListener( eventName, onNavigateRightClicked, false ); } );
+                               dom.controlsUp.forEach( function( el ) { el.removeEventListener( eventName, onNavigateUpClicked, false ); } );
+                               dom.controlsDown.forEach( function( el ) { el.removeEventListener( eventName, onNavigateDownClicked, false ); } );
+                               dom.controlsPrev.forEach( function( el ) { el.removeEventListener( eventName, onNavigatePrevClicked, false ); } );
+                               dom.controlsNext.forEach( function( el ) { el.removeEventListener( eventName, onNavigateNextClicked, false ); } );
+                       } );
                }
 
        }
@@ -475,31 +540,24 @@ var Reveal = (function(){
 
        }
 
-       /**
-        * Prevents an events defaults behavior calls the
-        * specified delegate.
-        *
-        * @param {Function} delegate The method to call
-        * after the wrapper has been executed
-        */
-       function preventAndForward( delegate ) {
-
-               return function( event ) {
-                       event.preventDefault();
-                       delegate.call( null, event );
-               };
-
-       }
-
        /**
         * Causes the address bar to hide on mobile devices,
         * more vertical space ftw.
         */
        function removeAddressBar() {
 
+               if( window.orientation === 0 ) {
+                       document.documentElement.style.overflow = 'scroll';
+                       document.body.style.height = '120%';
+               }
+               else {
+                       document.documentElement.style.overflow = '';
+                       document.body.style.height = '100%';
+               }
+
                setTimeout( function() {
                        window.scrollTo( 0, 1 );
-               }, 0 );
+               }, 10 );
 
        }
 
@@ -519,42 +577,138 @@ var Reveal = (function(){
        /**
         * Wrap all links in 3D goodness.
         */
-       function linkify() {
+       function enable3DLinks() {
 
                if( supports3DTransforms && !( 'msPerspective' in document.body.style ) ) {
-                       var nodes = document.querySelectorAll( SLIDES_SELECTOR + ' a:not(.image)' );
+                       var anchors = document.querySelectorAll( SLIDES_SELECTOR + ' a:not(.image)' );
 
-                       for( var i = 0, len = nodes.length; i < len; i++ ) {
-                               var node = nodes[i];
+                       for( var i = 0, len = anchors.length; i < len; i++ ) {
+                               var anchor = anchors[i];
 
-                               if( node.textContent && !node.querySelector( 'img' ) && ( !node.className || !node.classList.contains( node, 'roll' ) ) ) {
-                    var span = document.createElement('span');
-                    span.setAttribute('data-title', node.text);
-                    span.innerHTML = node.innerHTML;
+                               if( anchor.textContent && !anchor.querySelector( '*' ) && ( !anchor.className || !anchor.classList.contains( anchor, 'roll' ) ) ) {
+                                       var span = document.createElement('span');
+                                       span.setAttribute('data-title', anchor.text);
+                                       span.innerHTML = anchor.innerHTML;
 
-                                       node.classList.add( 'roll' );
-                    node.innerHTML = '';
-                    node.appendChild(span);
+                                       anchor.classList.add( 'roll' );
+                                       anchor.innerHTML = '';
+                                       anchor.appendChild(span);
                                }
                        }
                }
 
        }
 
+       /**
+        * Unwrap all 3D links.
+        */
+       function disable3DLinks() {
+
+               var anchors = document.querySelectorAll( SLIDES_SELECTOR + ' a.roll' );
+
+               for( var i = 0, len = anchors.length; i < len; i++ ) {
+                       var anchor = anchors[i];
+                       var span = anchor.querySelector( 'span' );
+
+                       if( span ) {
+                               anchor.classList.remove( 'roll' );
+                               anchor.innerHTML = span.innerHTML;
+                       }
+               }
+
+       }
+
+       /**
+        * Return a sorted fragments list, ordered by an increasing
+        * "data-fragment-index" attribute.
+        *
+        * Fragments will be revealed in the order that they are returned by
+        * this function, so you can use the index attributes to control the
+        * order of fragment appearance.
+        *
+        * To maintain a sensible default fragment order, fragments are presumed
+        * to be passed in document order. This function adds a "fragment-index"
+        * attribute to each node if such an attribute is not already present,
+        * and sets that attribute to an integer value which is the position of
+        * the fragment within the fragments list.
+        */
+       function sortFragments( fragments ) {
+
+               var a = toArray( fragments );
+
+               a.forEach( function( el, idx ) {
+                       if( !el.hasAttribute( 'data-fragment-index' ) ) {
+                               el.setAttribute( 'data-fragment-index', idx );
+                       }
+               } );
+
+               a.sort( function( l, r ) {
+                       return l.getAttribute( 'data-fragment-index' ) - r.getAttribute( 'data-fragment-index');
+               } );
+
+               return a;
+
+       }
+
        /**
         * Applies JavaScript-controlled layout rules to the
         * presentation.
         */
        function layout() {
 
-               if( config.center ) {
+               if( dom.wrapper ) {
+
+                       // Available space to scale within
+                       var availableWidth = dom.wrapper.offsetWidth,
+                               availableHeight = dom.wrapper.offsetHeight;
+
+                       // Reduce available space by margin
+                       availableWidth -= ( availableHeight * config.margin );
+                       availableHeight -= ( availableHeight * config.margin );
+
+                       // Dimensions of the content
+                       var slideWidth = config.width,
+                               slideHeight = config.height;
+
+                       // Slide width may be a percentage of available width
+                       if( typeof slideWidth === 'string' && /%$/.test( slideWidth ) ) {
+                               slideWidth = parseInt( slideWidth, 10 ) / 100 * availableWidth;
+                       }
+
+                       // Slide height may be a percentage of available height
+                       if( typeof slideHeight === 'string' && /%$/.test( slideHeight ) ) {
+                               slideHeight = parseInt( slideHeight, 10 ) / 100 * availableHeight;
+                       }
+
+                       dom.slides.style.width = slideWidth + 'px';
+                       dom.slides.style.height = slideHeight + 'px';
+
+                       // Determine scale of content to fit within available space
+                       scale = Math.min( availableWidth / slideWidth, availableHeight / slideHeight );
+
+                       // Respect max/min scale settings
+                       scale = Math.max( scale, config.minScale );
+                       scale = Math.min( scale, config.maxScale );
+
+                       // Prefer applying scale via zoom since Chrome blurs scaled content
+                       // with nested transforms
+                       if( typeof dom.slides.style.zoom !== 'undefined' && !navigator.userAgent.match( /(iphone|ipod|ipad|android)/gi ) ) {
+                               dom.slides.style.zoom = scale;
+                       }
+                       // Apply scale transform as a fallback
+                       else {
+                               var transform = 'translate(-50%, -50%) scale('+ scale +') translate(50%, 50%)';
+
+                               dom.slides.style.WebkitTransform = transform;
+                               dom.slides.style.MozTransform = transform;
+                               dom.slides.style.msTransform = transform;
+                               dom.slides.style.OTransform = transform;
+                               dom.slides.style.transform = transform;
+                       }
 
                        // Select all slides, vertical and horizontal
                        var slides = toArray( document.querySelectorAll( SLIDES_SELECTOR ) );
 
-                       // Determine the minimum top offset for slides
-                       var minTop = -dom.wrapper.offsetHeight / 2;
-
                        for( var i = 0, len = slides.length; i < len; i++ ) {
                                var slide = slides[ i ];
 
@@ -563,14 +717,20 @@ var Reveal = (function(){
                                        continue;
                                }
 
-                               // Vertical stacks are not centered since their section 
-                               // children will be
-                               if( slide.classList.contains( 'stack' ) ) {
-                                       slide.style.top = 0;
+                               if( config.center ) {
+                                       // Vertical stacks are not centred since their section
+                                       // children will be
+                                       if( slide.classList.contains( 'stack' ) ) {
+                                               slide.style.top = 0;
+                                       }
+                                       else {
+                                               slide.style.top = Math.max( - ( slide.offsetHeight / 2 ) - 20, -slideHeight / 2 ) + 'px';
+                                       }
                                }
                                else {
-                                       slide.style.top = Math.max( - ( slide.offsetHeight / 2 ) - 20, minTop ) + 'px';
+                                       slide.style.top = '';
                                }
+
                        }
 
                }
@@ -587,14 +747,14 @@ var Reveal = (function(){
         */
        function setPreviousVerticalIndex( stack, v ) {
 
-               if( stack ) {
+               if( typeof stack === 'object' && typeof stack.setAttribute === 'function' ) {
                        stack.setAttribute( 'data-previous-indexv', v || 0 );
                }
 
        }
 
        /**
-        * Retrieves the vertical index which was stored using 
+        * Retrieves the vertical index which was stored using
         * #setPreviousVerticalIndex() or 0 if no previous index
         * exists.
         *
@@ -602,7 +762,7 @@ var Reveal = (function(){
         */
        function getPreviousVerticalIndex( stack ) {
 
-               if( stack && stack.classList.contains( 'stack' ) ) {
+               if( typeof stack === 'object' && typeof stack.setAttribute === 'function' && stack.classList.contains( 'stack' ) ) {
                        return parseInt( stack.getAttribute( 'data-previous-indexv' ) || 0, 10 );
                }
 
@@ -622,14 +782,19 @@ var Reveal = (function(){
                // Only proceed if enabled in config
                if( config.overview ) {
 
+                       // Don't auto-slide while in overview mode
+                       cancelAutoSlide();
+
+                       var wasActive = dom.wrapper.classList.contains( 'overview' );
+
                        dom.wrapper.classList.add( 'overview' );
                        dom.wrapper.classList.remove( 'exit-overview' );
 
                        clearTimeout( activateOverviewTimeout );
                        clearTimeout( deactivateOverviewTimeout );
 
-                       // Not the pretties solution, but need to let the overview 
-                       // class apply first so that slides are measured accurately 
+                       // Not the pretties solution, but need to let the overview
+                       // class apply first so that slides are measured accurately
                        // before we can position them
                        activateOverviewTimeout = setTimeout( function(){
 
@@ -681,6 +846,15 @@ var Reveal = (function(){
 
                                layout();
 
+                               if( !wasActive ) {
+                                       // Notify observers of the overview showing
+                                       dispatchEvent( 'overviewshown', {
+                                               'indexh': indexh,
+                                               'indexv': indexv,
+                                               'currentSlide': currentSlide
+                                       } );
+                               }
+
                        }, 10 );
 
                }
@@ -730,6 +904,15 @@ var Reveal = (function(){
 
                        slide( indexh, indexv );
 
+                       cueAutoSlide();
+
+                       // Notify observers of the overview hiding
+                       dispatchEvent( 'overviewhidden', {
+                               'indexh': indexh,
+                               'indexv': indexv,
+                               'currentSlide': currentSlide
+                       } );
+
                }
        }
 
@@ -746,7 +929,7 @@ var Reveal = (function(){
                        override ? activateOverview() : deactivateOverview();
                }
                else {
-                       isOverviewActive() ? deactivateOverview() : activateOverview();
+                       isOverview() ? deactivateOverview() : activateOverview();
                }
 
        }
@@ -757,7 +940,7 @@ var Reveal = (function(){
         * @return {Boolean} true if the overview is active,
         * false otherwise
         */
-       function isOverviewActive() {
+       function isOverview() {
 
                return dom.wrapper.classList.contains( 'overview' );
 
@@ -791,8 +974,15 @@ var Reveal = (function(){
         */
        function pause() {
 
+               var wasPaused = dom.wrapper.classList.contains( 'paused' );
+
+               cancelAutoSlide();
                dom.wrapper.classList.add( 'paused' );
 
+               if( wasPaused === false ) {
+                       dispatchEvent( 'paused' );
+               }
+
        }
 
        /**
@@ -800,8 +990,15 @@ var Reveal = (function(){
         */
        function resume() {
 
+               var wasPaused = dom.wrapper.classList.contains( 'paused' );
                dom.wrapper.classList.remove( 'paused' );
 
+               cueAutoSlide();
+
+               if( wasPaused ) {
+                       dispatchEvent( 'resumed' );
+               }
+
        }
 
        /**
@@ -836,8 +1033,9 @@ var Reveal = (function(){
         * @param {int} v Vertical index of the target slide
         * @param {int} f Optional index of a fragment within the
         * target slide to activate
+        * @param {int} o Optional origin for use in multimaster environments
         */
-       function slide( h, v, f ) {
+       function slide( h, v, f, o ) {
 
                // Remember where we were at before
                previousSlide = currentSlide;
@@ -895,7 +1093,7 @@ var Reveal = (function(){
                }
 
                // If the overview is active, re-activate it to update positions
-               if( isOverviewActive() ) {
+               if( isOverview() ) {
                        activateOverview();
                }
 
@@ -914,7 +1112,7 @@ var Reveal = (function(){
 
                // Show fragment, if specified
                if( typeof f !== 'undefined' ) {
-                       var fragments = currentSlide.querySelectorAll( '.fragment' );
+                       var fragments = sortFragments( currentSlide.querySelectorAll( '.fragment' ) );
 
                        toArray( fragments ).forEach( function( fragment, indexf ) {
                                if( indexf < f ) {
@@ -932,7 +1130,8 @@ var Reveal = (function(){
                                'indexh': indexh,
                                'indexv': indexv,
                                'previousSlide': previousSlide,
-                               'currentSlide': currentSlide
+                               'currentSlide': currentSlide,
+                               'origin': o
                        } );
                }
                else {
@@ -946,20 +1145,20 @@ var Reveal = (function(){
                if( previousSlide ) {
                        previousSlide.classList.remove( 'present' );
 
-            // Reset all slides upon navigate to home
-            // Issue: #285
-            if ( document.querySelector( HOME_SLIDE_SELECTOR ).classList.contains( 'present' ) ) {
-                // Launch async task
-                setTimeout( function () {
-                    var slides = toArray( document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.stack') ), i;
-                    for( i in slides ) {
-                        if( slides[i] ) {
-                            // Reset stack
-                            setPreviousVerticalIndex( slides[i], 0 );
-                        }
-                    }
-                }, 0 );
-            }
+                       // Reset all slides upon navigate to home
+                       // Issue: #285
+                       if ( document.querySelector( HOME_SLIDE_SELECTOR ).classList.contains( 'present' ) ) {
+                               // Launch async task
+                               setTimeout( function () {
+                                       var slides = toArray( document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.stack') ), i;
+                                       for( i in slides ) {
+                                               if( slides[i] ) {
+                                                       // Reset stack
+                                                       setPreviousVerticalIndex( slides[i], 0 );
+                                               }
+                                       }
+                               }, 0 );
+                       }
                }
 
                updateControls();
@@ -1006,7 +1205,7 @@ var Reveal = (function(){
 
                                // Optimization; hide all slides that are three or more steps
                                // away from the present slide
-                               if( isOverviewActive() === false ) {
+                               if( isOverview() === false ) {
                                        // The distance loops so that it measures 1 between the first
                                        // and last slides
                                        var distance = Math.abs( ( index - i ) % ( slidesLength - 3 ) ) || 0;
@@ -1048,7 +1247,7 @@ var Reveal = (function(){
                        var slideAutoSlide = slides[index].getAttribute( 'data-autoslide' );
                        if( slideAutoSlide ) {
                                autoSlide = parseInt( slideAutoSlide, 10 );
-                       } 
+                       }
                        else {
                                autoSlide = config.autoSlide;
                        }
@@ -1156,8 +1355,8 @@ var Reveal = (function(){
                        verticalSlides = document.querySelectorAll( VERTICAL_SLIDES_SELECTOR );
 
                return {
-                       left: indexh > 0,
-                       right: indexh < horizontalSlides.length - 1,
+                       left: indexh > 0 || config.loop,
+                       right: indexh < horizontalSlides.length - 1 || config.loop,
                        up: indexv > 0,
                        down: indexv < verticalSlides.length - 1
                };
@@ -1285,7 +1484,8 @@ var Reveal = (function(){
 
                // Vertical slides:
                if( document.querySelector( VERTICAL_SLIDES_SELECTOR + '.present' ) ) {
-                       var verticalFragments = document.querySelectorAll( VERTICAL_SLIDES_SELECTOR + '.present .fragment:not(.visible)' );
+                       var verticalFragments = sortFragments( document.querySelectorAll( VERTICAL_SLIDES_SELECTOR + '.present .fragment:not(.visible)' ) );
+
                        if( verticalFragments.length ) {
                                verticalFragments[0].classList.add( 'visible' );
 
@@ -1296,7 +1496,8 @@ var Reveal = (function(){
                }
                // Horizontal slides:
                else {
-                       var horizontalFragments = document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.present .fragment:not(.visible)' );
+                       var horizontalFragments = sortFragments( document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.present .fragment:not(.visible)' ) );
+
                        if( horizontalFragments.length ) {
                                horizontalFragments[0].classList.add( 'visible' );
 
@@ -1320,7 +1521,8 @@ var Reveal = (function(){
 
                // Vertical slides:
                if( document.querySelector( VERTICAL_SLIDES_SELECTOR + '.present' ) ) {
-                       var verticalFragments = document.querySelectorAll( VERTICAL_SLIDES_SELECTOR + '.present .fragment.visible' );
+                       var verticalFragments = sortFragments( document.querySelectorAll( VERTICAL_SLIDES_SELECTOR + '.present .fragment.visible' ) );
+
                        if( verticalFragments.length ) {
                                verticalFragments[ verticalFragments.length - 1 ].classList.remove( 'visible' );
 
@@ -1331,7 +1533,8 @@ var Reveal = (function(){
                }
                // Horizontal slides:
                else {
-                       var horizontalFragments = document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.present .fragment.visible' );
+                       var horizontalFragments = sortFragments( document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.present .fragment.visible' ) );
+
                        if( horizontalFragments.length ) {
                                horizontalFragments[ horizontalFragments.length - 1 ].classList.remove( 'visible' );
 
@@ -1353,16 +1556,25 @@ var Reveal = (function(){
                clearTimeout( autoSlideTimeout );
 
                // Cue the next auto-slide if enabled
-               if( autoSlide ) {
+               if( autoSlide && !isPaused() && !isOverview() ) {
                        autoSlideTimeout = setTimeout( navigateNext, autoSlide );
                }
 
        }
 
+       /**
+        * Cancels any ongoing request to auto-slide.
+        */
+       function cancelAutoSlide() {
+
+               clearTimeout( autoSlideTimeout );
+
+       }
+
        function navigateLeft() {
 
                // Prioritize hiding fragments
-               if( availableRoutes().left && isOverviewActive() || previousFragment() === false ) {
+               if( availableRoutes().left && ( isOverview() || previousFragment() === false ) ) {
                        slide( indexh - 1 );
                }
 
@@ -1371,7 +1583,7 @@ var Reveal = (function(){
        function navigateRight() {
 
                // Prioritize revealing fragments
-               if( availableRoutes().right && isOverviewActive() || nextFragment() === false ) {
+               if( availableRoutes().right && ( isOverview() || nextFragment() === false ) ) {
                        slide( indexh + 1 );
                }
 
@@ -1380,7 +1592,7 @@ var Reveal = (function(){
        function navigateUp() {
 
                // Prioritize hiding fragments
-               if( availableRoutes().up && isOverviewActive() || previousFragment() === false ) {
+               if( availableRoutes().up && isOverview() || previousFragment() === false ) {
                        slide( indexh, indexv - 1 );
                }
 
@@ -1389,7 +1601,7 @@ var Reveal = (function(){
        function navigateDown() {
 
                // Prioritize revealing fragments
-               if( availableRoutes().down && isOverviewActive() || nextFragment() === false ) {
+               if( availableRoutes().down && isOverview() || nextFragment() === false ) {
                        slide( indexh, indexv + 1 );
                }
 
@@ -1415,7 +1627,7 @@ var Reveal = (function(){
                                if( previousSlide ) {
                                        indexv = ( previousSlide.querySelectorAll( 'section' ).length + 1 ) || undefined;
                                        indexh --;
-                                       slide();
+                                       slide( indexh, indexv );
                                }
                        }
                }
@@ -1458,10 +1670,15 @@ var Reveal = (function(){
 
                // Disregard the event if there's a focused element or a
                // keyboard modifier key is present
-               if ( hasFocus || event.shiftKey || event.altKey || event.ctrlKey || event.metaKey ) return;
+               if( hasFocus || (event.shiftKey && event.keyCode !== 32) || event.altKey || event.ctrlKey || event.metaKey ) return;
 
                var triggered = true;
 
+               // while paused only allow "unpausing" keyboard events (b and .)
+               if( isPaused() && [66,190,191].indexOf( event.keyCode ) === -1 ) {
+                       return false;
+               }
+
                switch( event.keyCode ) {
                        // p, page up
                        case 80: case 33: navigatePrev(); break;
@@ -1480,9 +1697,9 @@ var Reveal = (function(){
                        // end
                        case 35: slide( Number.MAX_VALUE ); break;
                        // space
-                       case 32: isOverviewActive() ? deactivateOverview() : navigateNext(); break;
+                       case 32: isOverview() ? deactivateOverview() : event.shiftKey ? navigatePrev() : navigateNext(); break;
                        // return
-                       case 13: isOverviewActive() ? deactivateOverview() : triggered = false; break;
+                       case 13: isOverview() ? deactivateOverview() : triggered = false; break;
                        // b, period, Logitech presenter tools "black screen" button
                        case 66: case 190: case 191: togglePause(); break;
                        // f
@@ -1509,10 +1726,10 @@ var Reveal = (function(){
        }
 
        /**
-        * Handler for the document level 'touchstart' event,
-        * enables support for swipe and pinch gestures.
+        * Handler for the 'touchstart' event, enables support for
+        * swipe and pinch gestures.
         */
-       function onDocumentTouchStart( event ) {
+       function onTouchStart( event ) {
 
                touch.startX = event.touches[0].clientX;
                touch.startY = event.touches[0].clientY;
@@ -1533,9 +1750,9 @@ var Reveal = (function(){
        }
 
        /**
-        * Handler for the document level 'touchmove' event.
+        * Handler for the 'touchmove' event.
         */
-       function onDocumentTouchMove( event ) {
+       function onTouchMove( event ) {
 
                // Each touch should only trigger one action
                if( !touch.handled ) {
@@ -1607,14 +1824,50 @@ var Reveal = (function(){
        }
 
        /**
-        * Handler for the document level 'touchend' event.
+        * Handler for the 'touchend' event.
         */
-       function onDocumentTouchEnd( event ) {
+       function onTouchEnd( event ) {
 
                touch.handled = false;
 
        }
 
+       /**
+        * Convert pointer down to touch start.
+        */
+       function onPointerDown( event ) {
+
+               if( event.pointerType === event.MSPOINTER_TYPE_TOUCH ) {
+                       event.touches = [{ clientX: event.clientX, clientY: event.clientY }];
+                       onTouchStart( event );
+               }
+
+       }
+
+       /**
+        * Convert pointer move to touch move.
+        */
+       function onPointerMove( event ) {
+
+               if( event.pointerType === event.MSPOINTER_TYPE_TOUCH ) {
+                       event.touches = [{ clientX: event.clientX, clientY: event.clientY }];
+                       onTouchMove( event );
+               }
+
+       }
+
+       /**
+        * Convert pointer up to touch end.
+        */
+       function onPointerUp( event ) {
+
+               if( event.pointerType === event.MSPOINTER_TYPE_TOUCH ) {
+                       event.touches = [{ clientX: event.clientX, clientY: event.clientY }];
+                       onTouchEnd( event );
+               }
+
+       }
+
        /**
         * Handles mouse wheel scrolling, throttled to avoid skipping
         * multiple slides.
@@ -1641,7 +1894,9 @@ var Reveal = (function(){
         *
         * ( clickX / presentationWidth ) * numberOfSlides
         */
-       function onProgressClick( event ) {
+       function onProgressClicked( event ) {
+
+               event.preventDefault();
 
                var slidesTotal = toArray( document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR ) ).length;
                var slideIndex = Math.floor( ( event.clientX / dom.wrapper.offsetWidth ) * slidesTotal );
@@ -1650,6 +1905,16 @@ var Reveal = (function(){
 
        }
 
+       /**
+        * Event handler for navigation control buttons.
+        */
+       function onNavigateLeftClicked( event ) { event.preventDefault(); navigateLeft(); }
+       function onNavigateRightClicked( event ) { event.preventDefault(); navigateRight(); }
+       function onNavigateUpClicked( event ) { event.preventDefault(); navigateUp(); }
+       function onNavigateDownClicked( event ) { event.preventDefault(); navigateDown(); }
+       function onNavigatePrevClicked( event ) { event.preventDefault(); navigatePrev(); }
+       function onNavigateNextClicked( event ) { event.preventDefault(); navigateNext(); }
+
        /**
         * Handler for the window level 'hashchange' event.
         */
@@ -1675,22 +1940,26 @@ var Reveal = (function(){
 
                // TODO There's a bug here where the event listeners are not
                // removed after deactivating the overview.
-               if( isOverviewActive() ) {
+               if( eventsAreBound && isOverview() ) {
                        event.preventDefault();
 
-                       deactivateOverview();
-
                        var element = event.target;
 
                        while( element && !element.nodeName.match( /section/gi ) ) {
                                element = element.parentNode;
                        }
 
-                       if( element.nodeName.match( /section/gi ) ) {
-                               var h = parseInt( element.getAttribute( 'data-index-h' ), 10 ),
-                                       v = parseInt( element.getAttribute( 'data-index-v' ), 10 );
+                       if( element && !element.classList.contains( 'disabled' ) ) {
+
+                               deactivateOverview();
+
+                               if( element.nodeName.match( /section/gi ) ) {
+                                       var h = parseInt( element.getAttribute( 'data-index-h' ), 10 ),
+                                               v = parseInt( element.getAttribute( 'data-index-v' ), 10 );
+
+                                       slide( h, v );
+                               }
 
-                               slide( h, v );
                        }
                }
 
@@ -1704,6 +1973,7 @@ var Reveal = (function(){
 
        return {
                initialize: initialize,
+               configure: configure,
 
                // Navigation methods
                slide: slide,
@@ -1728,12 +1998,19 @@ var Reveal = (function(){
                // Forces an update in slide layout
                layout: layout,
 
+               // Returns an object with the available routes as booleans (left/right/top/bottom)
+               availableRoutes: availableRoutes,
+
                // Toggles the overview mode on/off
                toggleOverview: toggleOverview,
 
                // Toggles the "black screen" mode on/off
                togglePause: togglePause,
 
+               // State checks
+               isOverview: isOverview,
+               isPaused: isPaused,
+
                // Adds or removes all internal event listeners (such as keyboard)
                addEventListeners: addEventListeners,
                removeEventListeners: removeEventListeners,
@@ -1741,6 +2018,18 @@ var Reveal = (function(){
                // Returns the indices of the current, or specified, slide
                getIndices: getIndices,
 
+               // Returns the slide at the specified index, y is optional
+               getSlide: function( x, y ) {
+                       var horizontalSlide = document.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR )[ x ];
+                       var verticalSlides = horizontalSlide && horizontalSlide.querySelectorAll( 'section' );
+
+                       if( typeof y !== 'undefined' ) {
+                               return verticalSlides ? verticalSlides[ y ] : undefined;
+                       }
+
+                       return horizontalSlide;
+               },
+
                // Returns the previous slide element, may be null
                getPreviousSlide: function() {
                        return previousSlide;
@@ -1751,6 +2040,27 @@ var Reveal = (function(){
                        return currentSlide;
                },
 
+               // Returns the current scale of the presentation content
+               getScale: function() {
+                       return scale;
+               },
+
+               // Returns the current configuration object
+               getConfig: function() {
+                       return config;
+               },
+
+               // Returns an index (1-based) of the current fragment
+               getCurrentFragmentIndex : function() {
+                       if( currentSlide ) {
+                               var visibleFragments = currentSlide.querySelectorAll( '.fragment.visible' );
+
+                               if( visibleFragments.length ) {
+                                       return visibleFragments.length;
+                               }
+                       }
+               },
+
                // Helper method, retrieves query string as a key/value hash
                getQueryHash: function() {
                        var query = {};
@@ -1762,6 +2072,21 @@ var Reveal = (function(){
                        return query;
                },
 
+               // Returns true if we're currently on the first slide
+               isFirstSlide: function() {
+                       return document.querySelector( SLIDES_SELECTOR + '.past' ) == null ? true : false;
+               },
+
+               // Returns true if we're currently on the last slide
+               isLastSlide: function() {
+                       if( currentSlide && currentSlide.classList.contains( '.stack' ) ) {
+                               return currentSlide.querySelector( SLIDES_SELECTOR + '.future' ) == null ? true : false;
+                       }
+                       else {
+                               return document.querySelector( SLIDES_SELECTOR + '.future' ) == null ? true : false;
+                       }
+               },
+
                // Forward event binding to the reveal DOM element
                addEventListener: function( type, listener, useCapture ) {
                        if( 'addEventListener' in window ) {
@@ -1775,4 +2100,4 @@ var Reveal = (function(){
                }
        };
 
-})();
\ No newline at end of file
+})();