revproxy-presentation/js/reveal.js

4242 lines
116 KiB
JavaScript
Raw Normal View History

import SlideContent from './controllers/slidecontent.js'
import AutoAnimate from './controllers/autoanimate.js'
2020-03-09 18:51:07 +01:00
import Fragments from './controllers/fragments.js'
2020-03-09 20:57:12 +01:00
import Overview from './controllers/overview.js'
import Plugins from './controllers/plugins.js'
2020-03-06 20:12:20 +01:00
import Playback from './components/playback.js'
2020-03-07 11:00:06 +01:00
import defaultConfig from './config.js'
2020-03-07 18:48:39 +01:00
import {
SLIDES_SELECTOR,
HORIZONTAL_SLIDES_SELECTOR,
VERTICAL_SLIDES_SELECTOR,
POST_MESSAGE_METHOD_BLACKLIST
} from './utils/constants.js'
import {
extend,
toArray,
distanceBetween,
deserialize,
transformElement,
createStyleSheet,
closestParent,
enterFullscreen
} from './utils/util.js'
2020-03-09 18:51:07 +01:00
import { isMobile, isChrome, isAndroid, supportsZoom } from './utils/device.js'
2020-03-07 18:48:39 +01:00
import { colorToRgb, colorBrightness } from './utils/color.js'
/**
2012-11-11 16:01:05 +01:00
* reveal.js
2017-11-22 14:46:55 +01:00
* http://revealjs.com
* MIT licensed
*
* Copyright (C) 2020 Hakim El Hattab, https://hakim.se
2011-06-07 21:10:59 +02:00
*/
export default function( revealElement, options ) {
const Reveal = {};
2014-04-09 02:08:21 +02:00
2016-01-08 10:26:41 +01:00
// The reveal.js version
2020-03-05 20:32:35 +01:00
const VERSION = '4.0.0-dev';
2016-01-08 10:26:41 +01:00
2020-03-05 20:32:35 +01:00
// Configuration defaults, can be overridden at initialization time
2020-03-07 11:00:06 +01:00
let config,
2011-12-22 05:22:49 +01:00
// Flags if reveal.js is loaded (has dispatched the 'ready' event)
ready = false,
2013-03-01 17:13:46 +01:00
// The horizontal and vertical index of the currently active slide
2013-07-21 04:51:52 +02:00
indexh,
indexv,
// The previous and current slide HTML elements
previousSlide,
currentSlide,
previousBackground,
// Remember which directions that the user has navigated towards
2020-02-06 15:19:09 +01:00
hasNavigatedHorizontally = false,
hasNavigatedVertically = false,
// Slides may hold a data-state attribute which we pick up and apply
// as a class to the body. This list contains the combined state of
// all current slides.
state = [],
// The current scale of the presentation (see width/height config)
scale = 1,
// CSS transform that is currently applied to the slides container,
// split into two groups
slidesTransform = { layout: '', overview: '' },
2011-12-22 05:22:49 +01:00
// Cached references to DOM elements
dom = {},
// Controller for plugin loading
plugins = new Plugins(),
// Controls loading and playback of slide content
slideContent = new SlideContent( Reveal ),
// Controls auto-animations between slides
autoAnimate = new AutoAnimate( Reveal ),
2020-03-09 18:51:07 +01:00
// Controls navigation between slide fragments
fragments = new Fragments( Reveal ),
2020-03-09 20:57:12 +01:00
overview = new Overview( Reveal ),
// List of asynchronously loaded reveal.js dependencies
asyncDependencies = [],
2012-01-15 04:22:27 +01:00
// Throttles mouse wheel navigation
2013-06-17 01:55:50 +02:00
lastMouseWheelStep = 0,
// Delays updates to the URL due to a Chrome thumbnailer bug
writeURLTimeout = 0,
// Is the mouse pointer currently hidden from view
cursorHidden = false,
// Timeout used to determine when the cursor is inactive
cursorInactiveTimeout = 0,
// Flags if the interaction event listeners are bound
eventsAreBound = false,
// The current auto-slide duration
autoSlide = 0,
// Auto slide properties
2013-10-13 19:02:50 +02:00
autoSlidePlayer,
autoSlideTimeout = 0,
autoSlideStartTime = -1,
autoSlidePaused = false,
2013-10-13 19:02:50 +02:00
// Holds information about the currently ongoing touch input
touch = {
startX: 0,
startY: 0,
startCount: 0,
2013-08-10 20:09:23 +02:00
captured: false,
threshold: 40
},
2019-04-01 13:11:29 +02:00
// A key:value map of shortcut keyboard keys and descriptions of
// the actions they trigger, generated in #configure()
keyboardShortcuts = {},
2018-03-22 11:10:27 +01:00
// Holds custom key code mappings
registeredKeyBindings = {};
2011-06-07 21:10:59 +02:00
/**
* Starts up the presentation if the client is capable.
2011-06-07 21:10:59 +02:00
*/
function initialize() {
2016-06-10 10:41:16 +02:00
if( !revealElement ) {
2020-03-07 18:48:39 +01:00
console.warn( 'reveal.js can not initialize without a valid .reveal element.' );
return;
}
2016-06-10 10:41:16 +02:00
// Cache references to key DOM elements
dom.wrapper = revealElement;
dom.slides = revealElement.querySelector( '.slides' );
// Force a layout when the whole page, incl fonts, has loaded
window.addEventListener( 'load', layout, false );
// Copy options over to our config object
2020-03-07 18:48:39 +01:00
config = { ...defaultConfig, ...options, ...Reveal.getQueryHash() };
2020-03-07 18:48:39 +01:00
// Load plugins then move on to #start()
plugins.load( config.dependencies ).then( start )
return Reveal;
}
/**
* Starts up reveal.js by binding input events and navigating
* to the current URL deeplink if there is one.
*/
function start() {
ready = true;
// Make sure we've got all the DOM elements we need
setupDOM();
// Listen to messages posted to this window
setupPostMessage();
2016-04-07 09:07:19 +02:00
// Prevent the slides from being scrolled out of view
setupScrollPrevention();
// Resets all vertical slides so that only the first is visible
resetVerticalSlides();
// Updates the presentation to match the current configuration values
configure();
// Read the initial hash
readURL();
// Update all backgrounds
updateBackground( true );
// Notify listeners that the presentation is ready but use a 1ms
// timeout to ensure it's not fired synchronously after #initialize()
2020-03-06 14:54:55 +01:00
setTimeout( () => {
// Enable transitions now that we're loaded
dom.slides.classList.remove( 'no-transition' );
2016-07-01 08:44:27 +02:00
dom.wrapper.classList.add( 'ready' );
dispatchEvent( 'ready', {
'indexh': indexh,
'indexv': indexv,
'currentSlide': currentSlide
} );
}, 1 );
// Special setup and config is required when printing to PDF
if( isPrintingPDF() ) {
removeEventListeners();
// The document needs to have loaded for the PDF layout
// measurements to be accurate
if( document.readyState === 'complete' ) {
setupPDF();
}
else {
window.addEventListener( 'load', setupPDF );
}
}
}
/**
* Finds and stores references to DOM elements which are
* required by the presentation. If a required element is
* not found, it is created.
*/
function setupDOM() {
// Prevent transitions while we're loading
dom.slides.classList.add( 'no-transition' );
2020-03-09 18:51:07 +01:00
if( isMobile ) {
2017-05-18 14:11:48 +02:00
dom.wrapper.classList.add( 'no-hover' );
}
else {
dom.wrapper.classList.remove( 'no-hover' );
}
// Background element
2013-08-11 16:34:04 +02:00
dom.background = createSingletonNode( dom.wrapper, 'div', 'backgrounds', null );
// Progress bar
2013-08-11 16:34:04 +02:00
dom.progress = createSingletonNode( dom.wrapper, 'div', 'progress', '<span></span>' );
dom.progressbar = dom.progress.querySelector( 'span' );
// Arrow controls
dom.controls = createSingletonNode( dom.wrapper, 'aside', 'controls',
2020-03-06 14:54:55 +01:00
`<button class="navigate-left" aria-label="${ config.rtl ? 'next slide' : 'previous slide' }"><div class="controls-arrow"></div></button>
<button class="navigate-right" aria-label="${ config.rtl ? 'previous slide' : 'next slide' }"><div class="controls-arrow"></div></button>
<button class="navigate-up" aria-label="above slide"><div class="controls-arrow"></div></button>
<button class="navigate-down" aria-label="below slide"><div class="controls-arrow"></div></button>` );
// Slide number
dom.slideNumber = createSingletonNode( dom.wrapper, 'div', 'slide-number', '' );
// Element containing notes that are visible to the audience
dom.speakerNotes = createSingletonNode( dom.wrapper, 'div', 'speaker-notes', null );
2015-09-10 11:26:05 +02:00
dom.speakerNotes.setAttribute( 'data-prevent-swipe', '' );
2016-05-23 10:50:39 +02:00
dom.speakerNotes.setAttribute( 'tabindex', '0' );
// Overlay graphic which is displayed during the paused mode
dom.pauseOverlay = createSingletonNode( dom.wrapper, 'div', 'pause-overlay', config.controls ? '<button class="resume-button">Resume presentation</button>' : null );
dom.wrapper.setAttribute( 'role', 'application' );
// There can be multiple instances of controls throughout the page
2020-03-07 14:12:28 +01:00
dom.controlsLeft = toArray( dom.wrapper.querySelectorAll( '.navigate-left' ) );
dom.controlsRight = toArray( dom.wrapper.querySelectorAll( '.navigate-right' ) );
dom.controlsUp = toArray( dom.wrapper.querySelectorAll( '.navigate-up' ) );
dom.controlsDown = toArray( dom.wrapper.querySelectorAll( '.navigate-down' ) );
dom.controlsPrev = toArray( dom.wrapper.querySelectorAll( '.navigate-prev' ) );
dom.controlsNext = toArray( dom.wrapper.querySelectorAll( '.navigate-next' ) );
// The left, right and down arrows in the standard reveal.js controls
dom.controlsRightArrow = dom.controls.querySelector( '.navigate-right' );
dom.controlsLeftArrow = dom.controls.querySelector( '.navigate-left' );
dom.controlsDownArrow = dom.controls.querySelector( '.navigate-down' );
2020-03-09 18:57:49 +01:00
dom.statusElement = createStatusElement();
}
/**
* Creates a hidden div with role aria-live to announce the
* current slide content. Hide the div off-screen to make it
* available only to Assistive Technologies.
2016-06-30 05:10:55 +02:00
*
* @return {HTMLElement}
*/
2020-03-09 18:57:49 +01:00
function createStatusElement() {
let statusElement = dom.wrapper.querySelector( '.aria-status' );
if( !statusElement ) {
statusElement = document.createElement( 'div' );
statusElement.style.position = 'absolute';
statusElement.style.height = '1px';
statusElement.style.width = '1px';
statusElement.style.overflow = 'hidden';
statusElement.style.clip = 'rect( 1px, 1px, 1px, 1px )';
statusElement.classList.add( 'aria-status' );
statusElement.setAttribute( 'aria-live', 'polite' );
statusElement.setAttribute( 'aria-atomic','true' );
dom.wrapper.appendChild( statusElement );
}
2020-03-09 18:57:49 +01:00
return statusElement;
}
2020-03-09 18:51:07 +01:00
/**
* Announces the given text to screen readers.
*/
function announceStatus( value ) {
2020-03-09 18:57:49 +01:00
dom.statusElement.textContent = value;
}
2016-10-05 12:00:21 +02:00
/**
* Converts the given HTML element into a string of text
* that can be announced to a screen reader. Hidden
* elements are excluded.
*/
function getStatusText( node ) {
2020-03-06 14:54:55 +01:00
let text = '';
2016-10-05 12:00:21 +02:00
// Text node
if( node.nodeType === 3 ) {
2016-08-18 10:40:56 +02:00
text += node.textContent;
2016-10-05 12:00:21 +02:00
}
// Element node
else if( node.nodeType === 1 ) {
2020-03-06 14:54:55 +01:00
let isAriaHidden = node.getAttribute( 'aria-hidden' );
let isDisplayHidden = window.getComputedStyle( node )['display'] === 'none';
2016-10-05 12:00:21 +02:00
if( isAriaHidden !== 'true' && !isDisplayHidden ) {
2020-03-06 14:54:55 +01:00
toArray( node.childNodes ).forEach( child => {
2016-10-05 12:00:21 +02:00
text += getStatusText( child );
} );
2016-08-18 10:40:56 +02:00
}
2016-10-05 12:00:21 +02:00
2016-08-18 10:40:56 +02:00
}
2016-10-05 12:00:21 +02:00
2020-03-07 14:12:28 +01:00
text = text.trim();
return text === '' ? '' : text + ' ';
2016-10-05 12:00:21 +02:00
2016-08-18 10:40:56 +02:00
}
/**
* Configures the presentation for printing to a static
* PDF.
*/
function setupPDF() {
2020-03-07 11:58:18 +01:00
let slideSize = getComputedSlideSize( window.innerWidth, window.innerHeight );
2014-04-23 21:18:13 +02:00
// Dimensions of the PDF pages
2020-03-07 11:58:18 +01:00
let pageWidth = Math.floor( slideSize.width * ( 1 + config.margin ) ),
pageHeight = Math.floor( slideSize.height * ( 1 + config.margin ) );
2014-04-23 21:18:13 +02:00
// Dimensions of slides within the pages
2020-03-07 11:58:18 +01:00
let slideWidth = slideSize.width,
slideHeight = slideSize.height;
// Let the browser know what page size we want to print
createStyleSheet( '@page{size:'+ pageWidth +'px '+ pageHeight +'px; margin: 0px;}' );
// Limit the size of certain elements to the dimensions of the slide
createStyleSheet( '.reveal section>img, .reveal section>video, .reveal section>iframe{max-width: '+ slideWidth +'px; max-height:'+ slideHeight +'px}' );
document.body.classList.add( 'print-pdf' );
document.body.style.width = pageWidth + 'px';
document.body.style.height = pageHeight + 'px';
// Make sure stretch elements fit on slide
2017-04-07 09:55:55 +02:00
layoutSlideContents( slideWidth, slideHeight );
2019-03-02 18:21:29 +01:00
// Compute slide numbers now, before we start duplicating slides
2020-03-07 11:58:18 +01:00
let doingSlideNumbers = config.slideNumber && /all|print/i.test( config.showSlideNumber );
2019-03-02 18:21:29 +01:00
toArray( dom.wrapper.querySelectorAll( SLIDES_SELECTOR ) ).forEach( function( slide ) {
slide.setAttribute( 'data-slide-number', getSlideNumber( slide ) );
} );
// Slide and slide background layout
toArray( dom.wrapper.querySelectorAll( SLIDES_SELECTOR ) ).forEach( function( slide ) {
// Vertical stacks are not centred since their section
// children will be
2014-04-23 21:18:13 +02:00
if( slide.classList.contains( 'stack' ) === false ) {
// Center the slide inside of the page, giving the slide some margin
2020-03-07 11:58:18 +01:00
let left = ( pageWidth - slideWidth ) / 2,
2014-04-23 21:18:13 +02:00
top = ( pageHeight - slideHeight ) / 2;
2020-03-07 11:58:18 +01:00
let contentHeight = slide.scrollHeight;
let numberOfPages = Math.max( Math.ceil( contentHeight / pageHeight ), 1 );
// Adhere to configured pages per slide limit
numberOfPages = Math.min( numberOfPages, config.pdfMaxPagesPerSlide );
2014-04-26 10:22:18 +02:00
// Center slides vertically
if( numberOfPages === 1 && config.center || slide.classList.contains( 'center' ) ) {
top = Math.max( ( pageHeight - contentHeight ) / 2, 0 );
}
// Wrap the slide in a page element and hide its overflow
// so that no page ever flows onto another
2020-03-07 11:58:18 +01:00
let page = document.createElement( 'div' );
2016-04-28 17:07:26 +02:00
page.className = 'pdf-page';
page.style.height = ( ( pageHeight + config.pdfPageHeightOffset ) * numberOfPages ) + 'px';
slide.parentNode.insertBefore( page, slide );
page.appendChild( slide );
// Position the slide inside of the page
slide.style.left = left + 'px';
slide.style.top = top + 'px';
slide.style.width = slideWidth + 'px';
2016-04-28 17:07:26 +02:00
if( slide.slideBackgroundElement ) {
page.insertBefore( slide.slideBackgroundElement, slide );
}
// Inject notes if `showNotes` is enabled
if( config.showNotes ) {
// Are there notes for this slide?
2020-03-07 11:58:18 +01:00
let notes = getSlideNotes( slide );
if( notes ) {
2020-03-07 11:58:18 +01:00
let notesSpacing = 8;
let notesLayout = typeof config.showNotes === 'string' ? config.showNotes : 'inline';
let notesElement = document.createElement( 'div' );
notesElement.classList.add( 'speaker-notes' );
notesElement.classList.add( 'speaker-notes-pdf' );
notesElement.setAttribute( 'data-layout', notesLayout );
notesElement.innerHTML = notes;
if( notesLayout === 'separate-page' ) {
page.parentNode.insertBefore( notesElement, page.nextSibling );
}
else {
notesElement.style.left = notesSpacing + 'px';
notesElement.style.bottom = notesSpacing + 'px';
notesElement.style.width = ( pageWidth - notesSpacing*2 ) + 'px';
page.appendChild( notesElement );
}
}
}
// Inject slide numbers if `slideNumbers` are enabled
2019-03-02 18:21:29 +01:00
if( doingSlideNumbers ) {
2020-03-07 11:58:18 +01:00
let numberElement = document.createElement( 'div' );
numberElement.classList.add( 'slide-number' );
numberElement.classList.add( 'slide-number-pdf' );
2019-03-02 18:21:29 +01:00
numberElement.innerHTML = slide.getAttribute( 'data-slide-number' );
2016-04-28 17:07:26 +02:00
page.appendChild( numberElement );
}
// Copy page and show fragments one after another
2018-06-11 12:35:11 +02:00
if( config.pdfSeparateFragments ) {
// Each fragment 'group' is an array containing one or more
// fragments. Multiple fragments that appear at the same time
// are part of the same group.
2020-03-09 18:51:07 +01:00
let fragmentGroups = fragments.sort( page.querySelectorAll( '.fragment' ), true );
2020-03-07 11:58:18 +01:00
let previousFragmentStep;
let previousPage;
2018-06-11 12:35:11 +02:00
fragmentGroups.forEach( function( fragments ) {
2018-06-11 12:35:11 +02:00
// Remove 'current-fragment' from the previous group
if( previousFragmentStep ) {
previousFragmentStep.forEach( function( fragment ) {
2018-06-11 12:35:11 +02:00
fragment.classList.remove( 'current-fragment' );
} );
}
2018-06-11 12:35:11 +02:00
// Show the fragments for the current index
fragments.forEach( function( fragment ) {
fragment.classList.add( 'visible', 'current-fragment' );
2017-08-08 22:53:32 +02:00
} );
// Create a separate page for the current fragment state
2020-03-07 11:58:18 +01:00
let clonedPage = page.cloneNode( true );
page.parentNode.insertBefore( clonedPage, ( previousPage || page ).nextSibling );
2018-06-11 12:35:11 +02:00
previousFragmentStep = fragments;
previousPage = clonedPage;
} );
// Reset the first/original page so that all fragments are hidden
fragmentGroups.forEach( function( fragments ) {
fragments.forEach( function( fragment ) {
fragment.classList.remove( 'visible', 'current-fragment' );
} );
} );
}
// Show all fragments
else {
2018-06-11 12:35:11 +02:00
toArray( page.querySelectorAll( '.fragment:not(.fade-out)' ) ).forEach( function( fragment ) {
fragment.classList.add( 'visible' );
} );
}
}
} );
// Notify subscribers that the PDF layout is good to go
dispatchEvent( 'pdf-ready' );
}
/**
2016-04-07 09:07:19 +02:00
* This is an unfortunate necessity. Some actions such as
* an input field being focused in an iframe or using the
* keyboard to expand text selection beyond the bounds of
* a slide can trigger our content to be pushed out of view.
* This scrolling can not be prevented by hiding overflow in
2016-04-07 09:07:19 +02:00
* CSS (we already do) so we have to resort to repeatedly
* checking if the slides have been offset :(
*/
2016-04-07 09:07:19 +02:00
function setupScrollPrevention() {
2020-03-06 14:54:55 +01:00
setInterval( () => {
2016-04-07 09:07:19 +02:00
if( dom.wrapper.scrollTop !== 0 || dom.wrapper.scrollLeft !== 0 ) {
dom.wrapper.scrollTop = 0;
dom.wrapper.scrollLeft = 0;
}
}, 1000 );
}
2013-08-11 22:47:56 +02:00
/**
* Creates an HTML element and returns a reference to it.
* If the element already exists the existing instance will
* be returned.
2016-06-30 05:10:55 +02:00
*
* @param {HTMLElement} container
* @param {string} tagname
* @param {string} classname
* @param {string} innerHTML
*
* @return {HTMLElement}
2013-08-11 22:47:56 +02:00
*/
2020-03-06 14:54:55 +01:00
function createSingletonNode( container, tagname, classname, innerHTML='' ) {
2013-08-11 16:34:04 +02:00
// Find all nodes matching the description
2020-03-06 14:54:55 +01:00
let nodes = container.querySelectorAll( '.' + classname );
// Check all matches to find one which is a direct child of
// the specified container
2020-03-06 14:54:55 +01:00
for( let i = 0; i < nodes.length; i++ ) {
let testNode = nodes[i];
if( testNode.parentNode === container ) {
return testNode;
2013-08-11 16:30:08 +02:00
}
}
// If no node was found, create it now
2020-03-06 14:54:55 +01:00
let node = document.createElement( tagname );
node.className = classname;
2020-03-06 14:54:55 +01:00
node.innerHTML = innerHTML;
container.appendChild( node );
return node;
2013-08-11 16:34:04 +02:00
}
/**
* Creates the slide background elements and appends them
* to the background container. One element is created per
* slide no matter if the given slide has visible background.
*/
function createBackgrounds() {
2020-03-06 14:54:55 +01:00
let printMode = isPrintingPDF();
// Clear prior backgrounds
dom.background.innerHTML = '';
dom.background.classList.add( 'no-transition' );
// Iterate over all horizontal slides
2020-03-06 14:54:55 +01:00
toArray( dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR ) ).forEach( slideh => {
2020-03-06 14:54:55 +01:00
let backgroundStack = createBackground( slideh, dom.background );
// Iterate over all vertical slides
2020-03-06 14:54:55 +01:00
toArray( slideh.querySelectorAll( 'section' ) ).forEach( slidev => {
2016-04-28 17:07:26 +02:00
createBackground( slidev, backgroundStack );
2014-04-27 15:39:11 +02:00
backgroundStack.classList.add( 'stack' );
} );
} );
// Add parallax background if specified
if( config.parallaxBackgroundImage ) {
dom.background.style.backgroundImage = 'url("' + config.parallaxBackgroundImage + '")';
dom.background.style.backgroundSize = config.parallaxBackgroundSize;
dom.background.style.backgroundRepeat = config.parallaxBackgroundRepeat;
dom.background.style.backgroundPosition = config.parallaxBackgroundPosition;
2013-09-10 21:23:10 +02:00
// Make sure the below properties are set on the element - these properties are
// needed for proper transitions to be set on the element via CSS. To remove
// annoying background slide-in effect when the presentation starts, apply
// these properties after short time delay
2020-03-06 14:54:55 +01:00
setTimeout( () => {
dom.wrapper.classList.add( 'has-parallax-background' );
2013-09-10 21:23:10 +02:00
}, 1 );
2013-09-10 21:23:10 +02:00
}
else {
dom.background.style.backgroundImage = '';
dom.wrapper.classList.remove( 'has-parallax-background' );
}
}
/**
* Creates a background for the given slide.
*
* @param {HTMLElement} slide
* @param {HTMLElement} container The element that the background
* should be appended to
2016-06-30 05:10:55 +02:00
* @return {HTMLElement} New background div
*/
function createBackground( slide, container ) {
2018-05-03 15:25:54 +02:00
// Main slide background element
2020-03-06 14:54:55 +01:00
let element = document.createElement( 'div' );
2018-05-03 15:25:54 +02:00
element.className = 'slide-background ' + slide.className.replace( /present|past|future/, '' );
// Inner background element that wraps images/videos/iframes
2020-03-06 14:54:55 +01:00
let contentElement = document.createElement( 'div' );
2018-05-03 15:25:54 +02:00
contentElement.className = 'slide-background-content';
element.appendChild( contentElement );
container.appendChild( element );
slide.slideBackgroundElement = element;
slide.slideBackgroundContentElement = contentElement;
// Syncs the background to reflect all current background settings
syncBackground( slide );
return element;
}
/**
* Renders all of the visual properties of a slide background
* based on the various background attributes.
*
* @param {HTMLElement} slide
*/
function syncBackground( slide ) {
2020-03-06 14:54:55 +01:00
let element = slide.slideBackgroundElement,
2018-05-03 15:25:54 +02:00
contentElement = slide.slideBackgroundContentElement;
// Reset the prior background state in case this is not the
// initial sync
slide.classList.remove( 'has-dark-background' );
slide.classList.remove( 'has-light-background' );
element.removeAttribute( 'data-loaded' );
element.removeAttribute( 'data-background-hash' );
element.removeAttribute( 'data-background-size' );
element.removeAttribute( 'data-background-transition' );
element.style.backgroundColor = '';
contentElement.style.backgroundSize = '';
contentElement.style.backgroundRepeat = '';
contentElement.style.backgroundPosition = '';
contentElement.style.backgroundImage = '';
contentElement.style.opacity = '';
contentElement.innerHTML = '';
2020-03-06 14:54:55 +01:00
let data = {
background: slide.getAttribute( 'data-background' ),
backgroundSize: slide.getAttribute( 'data-background-size' ),
backgroundImage: slide.getAttribute( 'data-background-image' ),
2014-03-26 15:48:28 +01:00
backgroundVideo: slide.getAttribute( 'data-background-video' ),
2014-10-09 12:34:10 +02:00
backgroundIframe: slide.getAttribute( 'data-background-iframe' ),
backgroundColor: slide.getAttribute( 'data-background-color' ),
backgroundRepeat: slide.getAttribute( 'data-background-repeat' ),
backgroundPosition: slide.getAttribute( 'data-background-position' ),
backgroundTransition: slide.getAttribute( 'data-background-transition' ),
backgroundOpacity: slide.getAttribute( 'data-background-opacity' )
};
if( data.background ) {
// Auto-wrap image urls in url(...)
if( /^(http|file|\/\/)/gi.test( data.background ) || /\.(svg|png|jpg|jpeg|gif|bmp)([?#\s]|$)/gi.test( data.background ) ) {
slide.setAttribute( 'data-background-image', data.background );
}
else {
element.style.background = data.background;
}
}
2014-03-26 15:48:28 +01:00
// Create a hash for this combination of background settings.
// This is used to determine when two slide backgrounds are
// the same.
2014-10-09 12:34:10 +02:00
if( data.background || data.backgroundColor || data.backgroundImage || data.backgroundVideo || data.backgroundIframe ) {
2014-03-26 15:48:28 +01:00
element.setAttribute( 'data-background-hash', data.background +
data.backgroundSize +
data.backgroundImage +
data.backgroundVideo +
2014-10-09 12:34:10 +02:00
data.backgroundIframe +
2014-03-26 15:48:28 +01:00
data.backgroundColor +
data.backgroundRepeat +
data.backgroundPosition +
data.backgroundTransition +
data.backgroundOpacity );
}
// Additional and optional background properties
if( data.backgroundSize ) element.setAttribute( 'data-background-size', data.backgroundSize );
if( data.backgroundColor ) element.style.backgroundColor = data.backgroundColor;
if( data.backgroundTransition ) element.setAttribute( 'data-background-transition', data.backgroundTransition );
if( slide.hasAttribute( 'data-preload' ) ) element.setAttribute( 'data-preload', '' );
// Background image options are set on the content wrapper
if( data.backgroundSize ) contentElement.style.backgroundSize = data.backgroundSize;
if( data.backgroundRepeat ) contentElement.style.backgroundRepeat = data.backgroundRepeat;
if( data.backgroundPosition ) contentElement.style.backgroundPosition = data.backgroundPosition;
if( data.backgroundOpacity ) contentElement.style.opacity = data.backgroundOpacity;
// If this slide has a background color, we add a class that
2014-09-10 10:12:25 +02:00
// signals if it is light or dark. If the slide has no background
// color, no class will be added
2020-03-06 14:54:55 +01:00
let contrastColor = data.backgroundColor;
// If no bg color was found, check the computed background
if( !contrastColor ) {
2020-03-06 14:54:55 +01:00
let computedBackgroundStyle = window.getComputedStyle( element );
if( computedBackgroundStyle && computedBackgroundStyle.backgroundColor ) {
contrastColor = computedBackgroundStyle.backgroundColor;
}
}
if( contrastColor ) {
2020-03-06 14:54:55 +01:00
let rgb = colorToRgb( contrastColor );
// Ignore fully transparent backgrounds. Some browsers return
// rgba(0,0,0,0) when reading the computed background color of
// an element with no background
if( rgb && rgb.a !== 0 ) {
if( colorBrightness( contrastColor ) < 128 ) {
slide.classList.add( 'has-dark-background' );
}
else {
slide.classList.add( 'has-light-background' );
}
2014-09-10 10:12:25 +02:00
}
}
}
/**
* Registers a listener to postMessage events, this makes it
* possible to call all reveal.js API methods from another
* window. For example:
*
* revealWindow.postMessage( JSON.stringify({
* method: 'slide',
* args: [ 2 ]
* }), '*' );
*/
function setupPostMessage() {
if( config.postMessage ) {
2020-03-06 14:54:55 +01:00
window.addEventListener( 'message', event => {
2020-03-09 09:33:27 +01:00
let data = event.data;
// Make sure we're dealing with JSON
if( typeof data === 'string' && data.charAt( 0 ) === '{' && data.charAt( data.length - 1 ) === '}' ) {
data = JSON.parse( data );
// Check if the requested method can be found
if( data.method && typeof Reveal[data.method] === 'function' ) {
if( POST_MESSAGE_METHOD_BLACKLIST.test( data.method ) === false ) {
2020-03-07 11:58:18 +01:00
const result = Reveal[data.method].apply( Reveal, data.args );
// Dispatch a postMessage event with the returned value from
// our method invocation for getter functions
dispatchPostMessage( 'callback', { method: data.method, result: result } );
}
else {
console.warn( 'reveal.js: "'+ data.method +'" is is blacklisted from the postMessage API' );
}
}
}
}, false );
}
}
/**
2013-04-27 22:09:38 +02:00
* Applies the configuration settings from the config
* object. May be called multiple times.
2016-06-30 05:10:55 +02:00
*
* @param {object} options
*/
function configure( options ) {
2020-03-06 14:54:55 +01:00
const oldTransition = config.transition;
// New config options may be passed when this method
// is invoked through the API after initialization
if( typeof options === 'object' ) extend( config, options );
// Abort if reveal.js hasn't finished loading, config
// changes will be applied automatically once ready
if( Reveal.isReady() === false ) return;
2020-03-06 14:54:55 +01:00
const numberOfSlides = dom.wrapper.querySelectorAll( SLIDES_SELECTOR ).length;
// Remove the previously configured transition class
dom.wrapper.classList.remove( oldTransition );
dom.wrapper.classList.add( config.transition );
dom.wrapper.setAttribute( 'data-transition-speed', config.transitionSpeed );
dom.wrapper.setAttribute( 'data-background-transition', config.backgroundTransition );
dom.controls.style.display = config.controls ? 'block' : 'none';
dom.progress.style.display = config.progress ? 'block' : 'none';
2012-11-17 21:59:28 +01:00
dom.controls.setAttribute( 'data-controls-layout', config.controlsLayout );
dom.controls.setAttribute( 'data-controls-back-arrows', config.controlsBackArrows );
if( config.shuffle ) {
shuffle();
}
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' );
}
// Exit the paused mode if it was configured off
if( config.pause === false ) {
resume();
}
if( config.showNotes ) {
dom.speakerNotes.setAttribute( 'data-layout', typeof config.showNotes === 'string' ? config.showNotes : 'inline' );
}
2012-01-15 04:22:27 +01:00
if( config.mouseWheel ) {
document.addEventListener( 'DOMMouseScroll', onDocumentMouseScroll, false ); // FF
document.addEventListener( 'mousewheel', onDocumentMouseScroll, false );
2012-01-15 04:22:27 +01:00
}
else {
document.removeEventListener( 'DOMMouseScroll', onDocumentMouseScroll, false ); // FF
document.removeEventListener( 'mousewheel', onDocumentMouseScroll, false );
}
2012-01-15 04:22:27 +01:00
// Auto-hide the mouse pointer when its inactive
if( config.hideInactiveCursor ) {
document.addEventListener( 'mousemove', onDocumentCursorActive, false );
document.addEventListener( 'mousedown', onDocumentCursorActive, false );
}
else {
showCursor();
document.removeEventListener( 'mousemove', onDocumentCursorActive, false );
document.removeEventListener( 'mousedown', onDocumentCursorActive, false );
}
// Iframe link previews
if( config.previewLinks ) {
enablePreviewLinks();
disablePreviewLinks( '[data-preview-link=false]' );
}
else {
disablePreviewLinks();
enablePreviewLinks( '[data-preview-link]:not([data-preview-link=false])' );
}
// Reset all changes made by auto-animations
autoAnimate.reset();
2020-01-31 10:46:28 +01:00
// Remove existing auto-slide controls
if( autoSlidePlayer ) {
autoSlidePlayer.destroy();
autoSlidePlayer = null;
}
// Generate auto-slide controls if needed
if( numberOfSlides > 1 && config.autoSlide && config.autoSlideStoppable ) {
2020-03-06 14:54:55 +01:00
autoSlidePlayer = new Playback( dom.wrapper, () => {
return Math.min( Math.max( ( Date.now() - autoSlideStartTime ) / autoSlide, 0 ), 1 );
2013-10-13 19:02:50 +02:00
} );
autoSlidePlayer.on( 'click', onAutoSlidePlayerClick );
autoSlidePaused = false;
2013-10-13 19:02:50 +02:00
}
2014-03-25 14:28:22 +01:00
// When fragments are turned off they should be visible
if( config.fragments === false ) {
2020-03-09 18:51:07 +01:00
fragments.showAll();
2014-03-25 14:28:22 +01:00
}
2017-02-20 11:49:19 +01:00
// Slide numbers
2020-03-06 14:54:55 +01:00
let slideNumberDisplay = 'none';
2017-02-20 11:49:19 +01:00
if( config.slideNumber && !isPrintingPDF() ) {
if( config.showSlideNumber === 'all' ) {
slideNumberDisplay = 'block';
}
else if( config.showSlideNumber === 'speaker' && isSpeakerNotes() ) {
slideNumberDisplay = 'block';
}
}
dom.slideNumber.style.display = slideNumberDisplay;
// Add the navigation mode to the DOM so we can adjust styling
if( config.navigationMode !== 'default' ) {
dom.wrapper.setAttribute( 'data-navigation-mode', config.navigationMode );
}
else {
dom.wrapper.removeAttribute( 'data-navigation-mode' );
}
2019-04-01 13:11:29 +02:00
// Define our contextual list of keyboard shortcuts
if( config.navigationMode === 'linear' ) {
2019-04-01 13:11:29 +02:00
keyboardShortcuts['&#8594; , &#8595; , SPACE , N , L , J'] = 'Next slide';
keyboardShortcuts['&#8592; , &#8593; , P , H , K'] = 'Previous slide';
}
else {
2019-04-01 13:11:29 +02:00
keyboardShortcuts['N , SPACE'] = 'Next slide';
keyboardShortcuts['P'] = 'Previous slide';
keyboardShortcuts['&#8592; , H'] = 'Navigate left';
keyboardShortcuts['&#8594; , L'] = 'Navigate right';
keyboardShortcuts['&#8593; , K'] = 'Navigate up';
keyboardShortcuts['&#8595; , J'] = 'Navigate down';
}
2019-04-01 13:11:29 +02:00
keyboardShortcuts['Home , Shift &#8592;'] = 'First slide';
keyboardShortcuts['End , Shift &#8594;'] = 'Last slide';
2019-04-01 13:11:29 +02:00
keyboardShortcuts['B , .'] = 'Pause';
keyboardShortcuts['F'] = 'Fullscreen';
keyboardShortcuts['ESC, O'] = 'Slide overview';
2013-04-27 22:09:38 +02:00
sync();
2013-03-04 21:59:44 +01:00
}
/**
* Binds all event listeners.
*/
function addEventListeners() {
eventsAreBound = true;
window.addEventListener( 'hashchange', onWindowHashChange, false );
window.addEventListener( 'resize', onWindowResize, false );
if( config.touch ) {
2018-03-22 11:55:44 +01:00
if( 'onpointerdown' in window ) {
// Use W3C pointer events
dom.wrapper.addEventListener( 'pointerdown', onPointerDown, false );
dom.wrapper.addEventListener( 'pointermove', onPointerMove, false );
dom.wrapper.addEventListener( 'pointerup', onPointerUp, false );
2013-12-02 23:23:51 +01:00
}
else if( window.navigator.msPointerEnabled ) {
// IE 10 uses prefixed version of pointer events
dom.wrapper.addEventListener( 'MSPointerDown', onPointerDown, false );
dom.wrapper.addEventListener( 'MSPointerMove', onPointerMove, false );
dom.wrapper.addEventListener( 'MSPointerUp', onPointerUp, false );
}
else {
// Fall back to touch events
dom.wrapper.addEventListener( 'touchstart', onTouchStart, false );
dom.wrapper.addEventListener( 'touchmove', onTouchMove, false );
dom.wrapper.addEventListener( 'touchend', onTouchEnd, false );
}
}
if( config.keyboard ) {
document.addEventListener( 'keydown', onDocumentKeyDown, false );
document.addEventListener( 'keypress', onDocumentKeyPress, false );
}
if( config.progress && dom.progress ) {
dom.progress.addEventListener( 'click', onProgressClicked, false );
}
dom.pauseOverlay.addEventListener( 'click', resume, false );
2014-06-05 10:59:30 +02:00
if( config.focusBodyOnPageVisibilityChange ) {
2020-03-02 14:52:50 +01:00
document.addEventListener( 'visibilitychange', onPageVisibilityChange, false );
}
// Listen to both touch and click events, in case the device
// supports both
2020-03-06 14:54:55 +01:00
let pointerEvents = [ 'touchstart', 'click' ];
// Only support touch for Android, fixes double navigations in
// stock browser
2020-03-09 18:51:07 +01:00
if( isAndroid ) {
pointerEvents = [ 'touchstart' ];
}
2020-03-07 11:58:18 +01:00
pointerEvents.forEach( eventName => {
dom.controlsLeft.forEach( el => el.addEventListener( eventName, onNavigateLeftClicked, false ) );
dom.controlsRight.forEach( el => el.addEventListener( eventName, onNavigateRightClicked, false ) );
dom.controlsUp.forEach( el => el.addEventListener( eventName, onNavigateUpClicked, false ) );
dom.controlsDown.forEach( el => el.addEventListener( eventName, onNavigateDownClicked, false ) );
dom.controlsPrev.forEach( el => el.addEventListener( eventName, onNavigatePrevClicked, false ) );
dom.controlsNext.forEach( el => el.addEventListener( eventName, onNavigateNextClicked, false ) );
} );
}
/**
* Unbinds all event listeners.
*/
function removeEventListeners() {
eventsAreBound = false;
document.removeEventListener( 'keydown', onDocumentKeyDown, false );
document.removeEventListener( 'keypress', onDocumentKeyPress, false );
window.removeEventListener( 'hashchange', onWindowHashChange, false );
window.removeEventListener( 'resize', onWindowResize, false );
dom.wrapper.removeEventListener( 'pointerdown', onPointerDown, false );
dom.wrapper.removeEventListener( 'pointermove', onPointerMove, false );
dom.wrapper.removeEventListener( 'pointerup', onPointerUp, false );
dom.wrapper.removeEventListener( 'MSPointerDown', onPointerDown, false );
dom.wrapper.removeEventListener( 'MSPointerMove', onPointerMove, false );
dom.wrapper.removeEventListener( 'MSPointerUp', onPointerUp, false );
dom.wrapper.removeEventListener( 'touchstart', onTouchStart, false );
dom.wrapper.removeEventListener( 'touchmove', onTouchMove, false );
dom.wrapper.removeEventListener( 'touchend', onTouchEnd, false );
dom.pauseOverlay.removeEventListener( 'click', resume, false );
if ( config.progress && dom.progress ) {
dom.progress.removeEventListener( 'click', onProgressClicked, false );
}
2020-03-07 11:58:18 +01:00
[ 'touchstart', 'click' ].forEach( eventName => {
dom.controlsLeft.forEach( el => el.removeEventListener( eventName, onNavigateLeftClicked, false ) );
dom.controlsRight.forEach( el => el.removeEventListener( eventName, onNavigateRightClicked, false ) );
dom.controlsUp.forEach( el => el.removeEventListener( eventName, onNavigateUpClicked, false ) );
dom.controlsDown.forEach( el => el.removeEventListener( eventName, onNavigateDownClicked, false ) );
dom.controlsPrev.forEach( el => el.removeEventListener( eventName, onNavigatePrevClicked, false ) );
dom.controlsNext.forEach( el => el.removeEventListener( eventName, onNavigateNextClicked, false ) );
} );
2011-06-07 21:10:59 +02:00
}
/**
2017-11-29 09:46:45 +01:00
* Add a custom key binding with optional description to
* be added to the help screen.
*/
2017-11-29 09:46:45 +01:00
function addKeyBinding( binding, callback ) {
if( typeof binding === 'object' && binding.keyCode ) {
registeredKeyBindings[binding.keyCode] = {
callback: callback,
key: binding.key,
description: binding.description
};
}
else {
registeredKeyBindings[binding] = {
callback: callback,
key: null,
description: null
};
}
2017-11-29 09:46:45 +01:00
}
/**
2017-11-29 09:46:45 +01:00
* Removes the specified custom key binding.
*/
2017-11-29 09:46:45 +01:00
function removeKeyBinding( keyCode ) {
delete registeredKeyBindings[keyCode];
}
/**
* Applies CSS transforms to the slides container. The container
* is transformed from two separate sources: layout and the overview
* mode.
2016-06-30 05:10:55 +02:00
*
* @param {object} transforms
*/
function transformSlides( transforms ) {
// Pick up new transforms from arguments
2015-01-29 12:21:05 +01:00
if( typeof transforms.layout === 'string' ) slidesTransform.layout = transforms.layout;
if( typeof transforms.overview === 'string' ) slidesTransform.overview = transforms.overview;
// Apply the transforms to the slides container
if( slidesTransform.layout ) {
transformElement( dom.slides, slidesTransform.layout + ' ' + slidesTransform.overview );
}
else {
transformElement( dom.slides, slidesTransform.overview );
}
}
/**
* Returns the remaining height within the parent of the
* target element.
*
* remaining height = [ configured parent height ] - [ current parent height ]
2017-03-18 03:47:25 +01:00
*
2016-06-30 05:10:55 +02:00
* @param {HTMLElement} element
* @param {number} [height]
*/
2020-03-06 14:54:55 +01:00
function getRemainingHeight( element, height = 0 ) {
if( element ) {
2020-03-06 14:54:55 +01:00
let newHeight, oldHeight = element.style.height;
// Change the .stretch element height to 0 in order find the height of all
// the other elements
element.style.height = '0px';
2019-01-07 14:43:46 +01:00
// In Overview mode, the parent (.slide) height is set of 700px.
// Restore it temporarily to its natural height.
element.parentNode.style.height = 'auto';
2019-01-07 14:43:46 +01:00
newHeight = height - element.parentNode.offsetHeight;
// Restore the old height, just in case
element.style.height = oldHeight + 'px';
// Clear the parent (.slide) height. .removeProperty works in IE9+
element.parentNode.style.removeProperty('height');
return newHeight;
}
return height;
}
/**
* Checks if this instance is being used to print a PDF.
*/
function isPrintingPDF() {
return ( /print-pdf/gi ).test( window.location.search );
}
/**
* Dispatches an event of the specified type from the
* reveal DOM element.
*/
function dispatchEvent( type, args ) {
2020-03-06 14:54:55 +01:00
let event = document.createEvent( 'HTMLEvents', 1, 2 );
event.initEvent( type, true, true );
extend( event, args );
dom.wrapper.dispatchEvent( event );
// If we're in an iframe, post each reveal.js event to the
// parent window. Used by the notes plugin
dispatchPostMessage( type );
}
/**
* Dispatched a postMessage of the given type from our window.
*/
function dispatchPostMessage( type, data ) {
if( config.postMessageEvents && window.parent !== window.self ) {
2020-03-06 14:54:55 +01:00
let message = {
namespace: 'reveal',
eventName: type,
state: getState()
};
extend( message, data );
window.parent.postMessage( JSON.stringify( message ), '*' );
}
}
/**
* Bind preview frame links.
2016-06-30 05:10:55 +02:00
*
* @param {string} [selector=a] - selector for anchors
*/
2020-03-06 14:54:55 +01:00
function enablePreviewLinks( selector = 'a' ) {
2020-03-07 14:12:28 +01:00
toArray( dom.wrapper.querySelectorAll( selector ) ).forEach( element => {
if( /^(http|www)/gi.test( element.getAttribute( 'href' ) ) ) {
element.addEventListener( 'click', onPreviewLinkClicked, false );
}
} );
}
/**
* Unbind preview frame links.
*/
2020-03-06 14:54:55 +01:00
function disablePreviewLinks( selector = 'a' ) {
2020-03-07 14:12:28 +01:00
toArray( dom.wrapper.querySelectorAll( selector ) ).forEach( element => {
if( /^(http|www)/gi.test( element.getAttribute( 'href' ) ) ) {
element.removeEventListener( 'click', onPreviewLinkClicked, false );
}
} );
}
/**
* Opens a preview window for the target URL.
2016-06-30 05:10:55 +02:00
*
* @param {string} url - url for preview iframe src
*/
function showPreview( url ) {
closeOverlay();
dom.overlay = document.createElement( 'div' );
dom.overlay.classList.add( 'overlay' );
dom.overlay.classList.add( 'overlay-preview' );
dom.wrapper.appendChild( dom.overlay );
2020-03-05 20:32:35 +01:00
dom.overlay.innerHTML =
`<header>
<a class="close" href="#"><span class="icon"></span></a>
<a class="external" href="${url}" target="_blank"><span class="icon"></span></a>
</header>
<div class="spinner"></div>
<div class="viewport">
<iframe src="${url}"></iframe>
<small class="viewport-inner">
<span class="x-frame-error">Unable to load iframe. This is likely due to the site's policy (x-frame-options).</span>
</small>
</div>`;
2020-03-06 14:54:55 +01:00
dom.overlay.querySelector( 'iframe' ).addEventListener( 'load', event => {
dom.overlay.classList.add( 'loaded' );
}, false );
2020-03-06 14:54:55 +01:00
dom.overlay.querySelector( '.close' ).addEventListener( 'click', event => {
closeOverlay();
event.preventDefault();
}, false );
2020-03-06 14:54:55 +01:00
dom.overlay.querySelector( '.external' ).addEventListener( 'click', event => {
closeOverlay();
}, false );
}
/**
* Open or close help overlay window.
*
* @param {Boolean} [override] Flag which overrides the
* toggle logic and forcibly sets the desired state. True means
* help is open, false means it's closed.
*/
function toggleHelp( override ){
2017-02-09 11:37:47 +01:00
if( typeof override === 'boolean' ) {
2017-02-09 11:37:47 +01:00
override ? showHelp() : closeOverlay();
}
2017-02-09 11:37:47 +01:00
else {
if( dom.overlay ) {
closeOverlay();
}
else {
2017-02-09 11:37:47 +01:00
showHelp();
}
}
}
/**
2016-06-30 05:10:55 +02:00
* Opens an overlay window with help material.
*/
function showHelp() {
if( config.help ) {
closeOverlay();
dom.overlay = document.createElement( 'div' );
dom.overlay.classList.add( 'overlay' );
dom.overlay.classList.add( 'overlay-help' );
dom.wrapper.appendChild( dom.overlay );
2020-03-06 14:54:55 +01:00
let html = '<p class="title">Keyboard Shortcuts</p><br/>';
html += '<table><th>KEY</th><th>ACTION</th>';
2020-03-07 11:58:18 +01:00
for( let key in keyboardShortcuts ) {
2020-03-05 20:32:35 +01:00
html += `<tr><td>${key}</td><td>${keyboardShortcuts[ key ]}</td></tr>`;
}
2017-11-29 09:46:45 +01:00
// Add custom key bindings that have associated descriptions
2020-03-07 11:58:18 +01:00
for( let binding in registeredKeyBindings ) {
2017-11-29 09:46:45 +01:00
if( registeredKeyBindings[binding].key && registeredKeyBindings[binding].description ) {
2020-03-05 20:32:35 +01:00
html += `<tr><td>${registeredKeyBindings[binding].key}</td><td>${registeredKeyBindings[binding].description}</td></tr>`;
}
}
html += '</table>';
2020-03-05 20:32:35 +01:00
dom.overlay.innerHTML = `
<header>
<a class="close" href="#"><span class="icon"></span></a>
</header>
<div class="viewport">
<div class="viewport-inner">${html}</div>
</div>
`;
2020-03-07 11:58:18 +01:00
dom.overlay.querySelector( '.close' ).addEventListener( 'click', event => {
closeOverlay();
event.preventDefault();
}, false );
}
}
/**
* Closes any currently open overlay.
*/
function closeOverlay() {
if( dom.overlay ) {
dom.overlay.parentNode.removeChild( dom.overlay );
dom.overlay = null;
}
}
/**
* Applies JavaScript-controlled layout rules to the
* presentation.
*/
function layout() {
if( dom.wrapper && !isPrintingPDF() ) {
if( !config.disableLayout ) {
// On some mobile devices '100vh' is taller than the visible
// viewport which leads to part of the presentation being
// cut off. To work around this we define our own '--vh' custom
// property where 100x adds up to the correct height.
//
// https://css-tricks.com/the-trick-to-viewport-units-on-mobile/
2020-03-09 18:51:07 +01:00
if( isMobile ) {
document.documentElement.style.setProperty( '--vh', ( window.innerHeight * 0.01 ) + 'px' );
}
2020-03-06 14:54:55 +01:00
const size = getComputedSlideSize();
2020-03-06 14:54:55 +01:00
const oldScale = scale;
2019-01-31 20:13:32 +01:00
// Layout the contents of the slides
layoutSlideContents( config.width, config.height );
dom.slides.style.width = size.width + 'px';
dom.slides.style.height = size.height + 'px';
// Determine scale of content to fit within available space
scale = Math.min( size.presentationWidth / size.width, size.presentationHeight / size.height );
// Respect max/min scale settings
scale = Math.max( scale, config.minScale );
scale = Math.min( scale, config.maxScale );
// Don't apply any scaling styles if scale is 1
if( scale === 1 ) {
dom.slides.style.zoom = '';
dom.slides.style.left = '';
dom.slides.style.top = '';
dom.slides.style.bottom = '';
dom.slides.style.right = '';
transformSlides( { layout: '' } );
}
else {
// Zoom Scaling
// Content remains crisp no matter how much we scale. Side
// effects are minor differences in text layout and iframe
// viewports changing size. A 200x200 iframe viewport in a
// 2x zoomed presentation ends up having a 400x400 viewport.
2020-03-09 18:51:07 +01:00
if( scale > 1 && supportsZoom && window.devicePixelRatio < 2 ) {
dom.slides.style.zoom = scale;
dom.slides.style.left = '';
dom.slides.style.top = '';
dom.slides.style.bottom = '';
dom.slides.style.right = '';
transformSlides( { layout: '' } );
}
// Transform Scaling
// Content layout remains the exact same when scaled up.
// Side effect is content becoming blurred, especially with
// high scale values on ldpi screens.
else {
dom.slides.style.zoom = '';
dom.slides.style.left = '50%';
dom.slides.style.top = '50%';
dom.slides.style.bottom = 'auto';
dom.slides.style.right = 'auto';
transformSlides( { layout: 'translate(-50%, -50%) scale('+ scale +')' } );
}
}
// Select all slides, vertical and horizontal
2020-03-06 14:54:55 +01:00
const slides = toArray( dom.wrapper.querySelectorAll( SLIDES_SELECTOR ) );
2020-03-07 11:58:18 +01:00
for( let i = 0, len = slides.length; i < len; i++ ) {
2020-03-06 14:54:55 +01:00
const slide = slides[ i ];
// Don't bother updating invisible slides
if( slide.style.display === 'none' ) {
continue;
}
2020-03-06 14:54:55 +01:00
if( config.center || slide.classList.contains( '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( ( size.height - slide.scrollHeight ) / 2, 0 ) + 'px';
}
}
else {
slide.style.top = '';
}
}
2019-01-31 20:13:32 +01:00
if( oldScale !== scale ) {
2019-01-15 13:13:19 +01:00
dispatchEvent( 'resize', {
2019-01-31 20:13:32 +01:00
'oldScale': oldScale,
2019-01-15 13:13:19 +01:00
'scale': scale,
'size': size
} );
}
}
2013-04-27 22:10:47 +02:00
updateProgress();
updateParallax();
2013-04-27 22:10:47 +02:00
2020-03-09 20:57:12 +01:00
if( overview.isActive() ) {
overview.update();
}
}
}
2013-08-18 23:53:41 +02:00
/**
* Applies layout logic to the contents of all slides in
* the presentation.
2016-06-30 05:10:55 +02:00
*
* @param {string|number} width
* @param {string|number} height
2013-08-18 23:53:41 +02:00
*/
function layoutSlideContents( width, height ) {
2013-08-18 23:53:41 +02:00
// Handle sizing of elements with the 'stretch' class
2020-03-06 14:54:55 +01:00
toArray( dom.slides.querySelectorAll( 'section > .stretch' ) ).forEach( element => {
2013-08-18 23:53:41 +02:00
// Determine how much vertical space we can use
2020-03-07 11:58:18 +01:00
let remainingHeight = getRemainingHeight( element, height );
2013-08-18 23:53:41 +02:00
// Consider the aspect ratio of media elements
if( /(img|video)/gi.test( element.nodeName ) ) {
2020-03-06 14:54:55 +01:00
const nw = element.naturalWidth || element.videoWidth,
nh = element.naturalHeight || element.videoHeight;
2013-08-18 23:53:41 +02:00
2020-03-06 14:54:55 +01:00
const es = Math.min( width / nw, remainingHeight / nh );
2013-08-18 23:53:41 +02:00
element.style.width = ( nw * es ) + 'px';
element.style.height = ( nh * es ) + 'px';
}
else {
element.style.width = width + 'px';
element.style.height = remainingHeight + 'px';
}
} );
}
/**
* Calculates the computed pixel size of our slides. These
* values are based on the width and height configuration
* options.
2016-06-30 05:10:55 +02:00
*
* @param {number} [presentationWidth=dom.wrapper.offsetWidth]
* @param {number} [presentationHeight=dom.wrapper.offsetHeight]
*/
function getComputedSlideSize( presentationWidth, presentationHeight ) {
2020-03-06 14:54:55 +01:00
const size = {
// Slide size
width: config.width,
height: config.height,
// Presentation size
presentationWidth: presentationWidth || dom.wrapper.offsetWidth,
presentationHeight: presentationHeight || dom.wrapper.offsetHeight
};
// Reduce available space by margin
2015-03-19 04:49:19 +01:00
size.presentationWidth -= ( size.presentationWidth * config.margin );
size.presentationHeight -= ( size.presentationHeight * config.margin );
// Slide width may be a percentage of available width
if( typeof size.width === 'string' && /%$/.test( size.width ) ) {
size.width = parseInt( size.width, 10 ) / 100 * size.presentationWidth;
}
// Slide height may be a percentage of available height
if( typeof size.height === 'string' && /%$/.test( size.height ) ) {
size.height = parseInt( size.height, 10 ) / 100 * size.presentationHeight;
}
return size;
}
/**
* Stores the vertical index of a stack so that the same
* vertical slide can be selected when navigating to and
* from the stack.
*
* @param {HTMLElement} stack The vertical stack element
2016-06-30 05:10:55 +02:00
* @param {string|number} [v=0] Index to memorize
*/
function setPreviousVerticalIndex( stack, v ) {
if( typeof stack === 'object' && typeof stack.setAttribute === 'function' ) {
stack.setAttribute( 'data-previous-indexv', v || 0 );
}
}
/**
* Retrieves the vertical index which was stored using
* #setPreviousVerticalIndex() or 0 if no previous index
* exists.
*
* @param {HTMLElement} stack The vertical stack element
*/
function getPreviousVerticalIndex( stack ) {
if( typeof stack === 'object' && typeof stack.setAttribute === 'function' && stack.classList.contains( 'stack' ) ) {
2013-05-06 00:40:08 +02:00
// Prefer manually defined start-indexv
2020-03-06 14:54:55 +01:00
const attributeName = stack.hasAttribute( 'data-start-indexv' ) ? 'data-start-indexv' : 'data-previous-indexv';
2013-05-06 00:40:08 +02:00
return parseInt( stack.getAttribute( attributeName ) || 0, 10 );
}
return 0;
}
/**
* Return a hash URL that will resolve to the given slide location.
*
* @param {HTMLElement} [slide=currentSlide] The slide to link to
*/
function locationHash( slide ) {
2020-03-06 14:54:55 +01:00
let url = '/';
// Attempt to create a named link based on the slide's ID
2020-03-06 14:54:55 +01:00
let s = slide || currentSlide;
let id = s ? s.getAttribute( 'id' ) : null;
if( id ) {
id = encodeURIComponent( id );
}
2020-03-06 14:54:55 +01:00
let index = getIndices( slide );
if( !config.fragmentInURL ) {
index.f = undefined;
}
// If the current slide has an ID, use that as a named link,
// but we don't support named links with a fragment index
if( typeof id === 'string' && id.length && index.f === undefined ) {
url = '/' + id;
}
// Otherwise use the /h/v index
else {
2020-03-06 14:54:55 +01:00
let hashIndexBase = config.hashOneBasedIndex ? 1 : 0;
if( index.h > 0 || index.v > 0 || index.f !== undefined ) url += index.h + hashIndexBase;
if( index.v > 0 || index.f !== undefined ) url += '/' + (index.v + hashIndexBase );
if( index.f !== undefined ) url += '/' + index.f;
}
return url;
}
2013-04-30 04:07:09 +02:00
/**
* Checks if the current or specified slide is vertical
* (nested within another slide).
*
2016-06-30 05:10:55 +02:00
* @param {HTMLElement} [slide=currentSlide] The slide to check
2013-04-30 04:07:09 +02:00
* orientation of
2016-06-30 05:10:55 +02:00
* @return {Boolean}
2013-04-30 04:07:09 +02:00
*/
2020-03-06 14:54:55 +01:00
function isVerticalSlide( slide = currentSlide ) {
2013-04-30 04:07:09 +02:00
return slide && slide.parentNode && !!slide.parentNode.nodeName.match( /section/i );
2013-04-30 04:07:09 +02:00
}
2020-03-09 20:57:12 +01:00
/**
* Returns true if we're on the last slide in the current
* vertical stack.
*/
function isLastVerticalSlide() {
if( currentSlide && isVerticalSlide( currentSlide ) ) {
// Does this slide have a next sibling?
if( currentSlide.nextElementSibling ) return false;
return true;
}
return false;
}
/**
* Returns true if we're currently on the first slide in
* the presentation.
*/
function isFirstSlide() {
return indexh === 0 && indexv === 0;
}
/**
* Returns true if we're currently on the last slide in
* the presenation. If the last slide is a stack, we only
* consider this the last slide if it's at the end of the
* stack.
*/
function isLastSlide() {
if( currentSlide ) {
// Does this slide have a next sibling?
if( currentSlide.nextElementSibling ) return false;
// If it's vertical, does its parent have a next sibling?
if( isVerticalSlide( currentSlide ) && currentSlide.parentNode.nextElementSibling ) return false;
return true;
}
return false;
}
/**
* Shows the mouse pointer after it has been hidden with
* #hideCursor.
*/
function showCursor() {
if( cursorHidden ) {
cursorHidden = false;
dom.wrapper.style.cursor = '';
}
}
/**
* Hides the mouse pointer when it's on top of the .reveal
* container.
*/
function hideCursor() {
if( cursorHidden === false ) {
cursorHidden = true;
dom.wrapper.style.cursor = 'none';
}
}
/**
* Enters the paused mode which fades everything on screen to
* black.
*/
function pause() {
if( config.pause ) {
2020-03-06 14:54:55 +01:00
const wasPaused = dom.wrapper.classList.contains( 'paused' );
cancelAutoSlide();
dom.wrapper.classList.add( 'paused' );
if( wasPaused === false ) {
dispatchEvent( 'paused' );
}
}
}
/**
* Exits from the paused mode.
*/
function resume() {
2020-03-06 14:54:55 +01:00
const wasPaused = dom.wrapper.classList.contains( 'paused' );
dom.wrapper.classList.remove( 'paused' );
cueAutoSlide();
if( wasPaused ) {
dispatchEvent( 'resumed' );
}
}
/**
* Toggles the paused mode on and off.
*/
function togglePause( override ) {
if( typeof override === 'boolean' ) {
override ? pause() : resume();
}
else {
isPaused() ? resume() : pause();
}
}
/**
* Checks if we are currently in the paused mode.
2016-06-30 05:10:55 +02:00
*
* @return {Boolean}
*/
function isPaused() {
return dom.wrapper.classList.contains( 'paused' );
}
/**
* Toggles the auto slide mode on and off.
*
2016-06-30 05:10:55 +02:00
* @param {Boolean} [override] Flag which sets the desired state.
* True means autoplay starts, false means it stops.
*/
function toggleAutoSlide( override ) {
if( typeof override === 'boolean' ) {
override ? resumeAutoSlide() : pauseAutoSlide();
}
else {
autoSlidePaused ? resumeAutoSlide() : pauseAutoSlide();
}
}
/**
* Checks if the auto slide mode is currently on.
2016-06-30 05:10:55 +02:00
*
* @return {Boolean}
*/
2013-12-21 17:27:33 +01:00
function isAutoSliding() {
return !!( autoSlide && !autoSlidePaused );
}
2011-06-07 21:10:59 +02:00
/**
* Steps from the current point in the presentation to the
* slide which matches the specified horizontal and vertical
* indices.
*
2016-06-30 05:10:55 +02:00
* @param {number} [h=indexh] Horizontal index of the target slide
* @param {number} [v=indexv] Vertical index of the target slide
* @param {number} [f] Index of a fragment within the
* target slide to activate
2016-06-30 05:10:55 +02:00
* @param {number} [o] Origin for use in multimaster environments
2011-06-07 21:10:59 +02:00
*/
2013-03-08 01:51:58 +01:00
function slide( h, v, f, o ) {
// Remember where we were at before
previousSlide = currentSlide;
// Query all horizontal slides in the deck
2020-03-06 14:54:55 +01:00
const horizontalSlides = dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR );
// Abort if there are no slides
if( horizontalSlides.length === 0 ) return;
// If no vertical index is specified and the upcoming slide is a
// stack, resume at its previous vertical index
2020-03-09 20:57:12 +01:00
if( v === undefined && !overview.isActive() ) {
v = getPreviousVerticalIndex( horizontalSlides[ h ] );
}
// If we were on a vertical stack, remember what vertical index
// it was on so we can resume at the same position when returning
if( previousSlide && previousSlide.parentNode && previousSlide.parentNode.classList.contains( 'stack' ) ) {
setPreviousVerticalIndex( previousSlide.parentNode, indexv );
}
2012-03-31 05:51:37 +02:00
// Remember the state before this slide
2020-03-06 14:54:55 +01:00
const stateBefore = state.concat();
2012-03-31 05:51:37 +02:00
// Reset the state array
state.length = 0;
2020-03-06 14:54:55 +01:00
let indexhBefore = indexh || 0,
indexvBefore = indexv || 0;
2012-03-31 05:51:37 +02:00
// Activate and transition to the new slide
indexh = updateSlides( HORIZONTAL_SLIDES_SELECTOR, h === undefined ? indexh : h );
indexv = updateSlides( VERTICAL_SLIDES_SELECTOR, v === undefined ? indexv : v );
// Update the visibility of slides now that the indices have changed
updateSlidesVisibility();
layout();
2015-01-29 12:21:05 +01:00
// Update the overview if it's currently active
2020-03-09 20:57:12 +01:00
if( overview.isActive() ) {
overview.update();
}
// Find the current horizontal slide and any possible vertical slides
// within it
2020-03-06 14:54:55 +01:00
let currentHorizontalSlide = horizontalSlides[ indexh ],
currentVerticalSlides = currentHorizontalSlide.querySelectorAll( 'section' );
// Store references to the previous and current slides
currentSlide = currentVerticalSlides[ indexv ] || currentHorizontalSlide;
// Show fragment, if specified
if( typeof f !== 'undefined' ) {
2020-03-09 18:51:07 +01:00
fragments.goto( f );
}
// Dispatch an event if the slide changed
2020-03-06 14:54:55 +01:00
let slideChanged = ( indexh !== indexhBefore || indexv !== indexvBefore );
if (!slideChanged) {
// Ensure that the previous slide is never the same as the current
previousSlide = null;
}
// Solves an edge case where the previous slide maintains the
// 'present' class when navigating between adjacent vertical
// stacks
if( previousSlide && previousSlide !== currentSlide ) {
previousSlide.classList.remove( 'present' );
previousSlide.setAttribute( 'aria-hidden', 'true' );
2013-01-11 22:43:43 +01:00
// Reset all slides upon navigate to home
2020-03-09 20:57:12 +01:00
if( isFirstSlide() ) {
// Launch async task
2020-03-06 14:54:55 +01:00
setTimeout( () => {
getVerticalStacks().forEach( slide => {
setPreviousVerticalIndex( slide, 0 );
} );
}, 0 );
}
}
// Apply the new state
2020-03-06 14:54:55 +01:00
stateLoop: for( let i = 0, len = state.length; i < len; i++ ) {
// Check if this state existed on the previous slide. If it
// did, we will avoid adding it repeatedly
2020-03-06 14:54:55 +01:00
for( let j = 0; j < stateBefore.length; j++ ) {
if( stateBefore[j] === state[i] ) {
stateBefore.splice( j, 1 );
continue stateLoop;
}
}
document.documentElement.classList.add( state[i] );
// Dispatch custom event matching the state's name
dispatchEvent( state[i] );
}
// Clean up the remains of the previous state
while( stateBefore.length ) {
document.documentElement.classList.remove( stateBefore.pop() );
}
if( slideChanged ) {
dispatchEvent( 'slidechanged', {
'indexh': indexh,
'indexv': indexv,
'previousSlide': previousSlide,
'currentSlide': currentSlide,
'origin': o
} );
}
// Handle embedded content
2014-05-20 08:53:25 +02:00
if( slideChanged || !previousSlide ) {
slideContent.stopEmbeddedContent( previousSlide );
slideContent.startEmbeddedContent( currentSlide );
}
2020-03-09 18:51:07 +01:00
// Announce the current slide contents to screen readers
announceStatus( getStatusText( currentSlide ) );
updateControls();
updateProgress();
updateBackground();
updateParallax();
updateSlideNumber();
updateNotes();
2020-03-09 18:51:07 +01:00
fragments.update();
2013-07-19 15:23:17 +02:00
// Update the URL hash
writeURL();
cueAutoSlide();
2020-02-01 19:11:52 +01:00
// Auto-animation
2020-03-09 20:57:12 +01:00
if( slideChanged && previousSlide && currentSlide && !overview.isActive() ) {
2020-02-01 19:11:52 +01:00
// Skip the slide transition between our two slides
// when auto-animating individual elements
if( previousSlide.hasAttribute( 'data-auto-animate' ) && currentSlide.hasAttribute( 'data-auto-animate' ) ) {
dom.slides.classList.add( 'disable-slide-transitions' );
2020-02-01 19:11:52 +01:00
2020-03-06 14:54:55 +01:00
setTimeout( () => {
dom.slides.classList.remove( 'disable-slide-transitions' );
2020-02-01 19:11:52 +01:00
}, 0 );
if( config.autoAnimate ) {
// Run the auto-animation between our slides
autoAnimate.run( previousSlide, currentSlide );
}
}
2020-02-01 19:11:52 +01:00
2020-01-31 10:46:28 +01:00
}
2011-06-07 21:10:59 +02:00
}
2013-04-27 22:09:38 +02:00
/**
* Syncs the presentation with the current DOM. Useful
* when new slides or control elements are added or when
* the configuration has changed.
*/
function sync() {
// 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();
// Re-create the slide backgrounds
createBackgrounds();
// Write the current hash to the URL
writeURL();
2020-03-09 18:51:07 +01:00
fragments.sortAll();
2013-11-25 21:40:24 +01:00
updateControls();
updateProgress();
updateSlideNumber();
updateSlidesVisibility();
updateBackground( true );
updateNotesVisibility();
updateNotes();
slideContent.formatEmbeddedContent();
// Start or stop embedded content depending on global config
if( config.autoPlayMedia === false ) {
slideContent.stopEmbeddedContent( currentSlide, { unloadIframes: false } );
}
else {
slideContent.startEmbeddedContent( currentSlide );
}
2020-03-09 20:57:12 +01:00
if( overview.isActive() ) {
overview.layout();
2015-01-27 09:21:49 +01:00
}
2013-04-27 22:09:38 +02:00
}
2018-05-03 15:25:54 +02:00
/**
* Updates reveal.js to keep in sync with new slide attributes. For
* example, if you add a new `data-background-image` you can call
* this to have reveal.js render the new background image.
*
* Similar to #sync() but more efficient when you only need to
* refresh a specific slide.
*
* @param {HTMLElement} slide
*/
2020-03-06 17:40:11 +01:00
function syncSlide( slide = currentSlide ) {
2018-05-03 15:25:54 +02:00
syncBackground( slide );
2018-05-31 10:35:07 +02:00
syncFragments( slide );
2018-05-03 15:25:54 +02:00
slideContent.load( slide );
2018-05-03 15:25:54 +02:00
updateBackground();
updateNotes();
}
2018-05-31 10:35:07 +02:00
/**
* Formats the fragments on the given slide so that they have
* valid indices. Call this if fragments are changed in the DOM
* after reveal.js has already initialized.
*
* @param {HTMLElement} slide
* @return {Array} a list of the HTML fragments that were synced
2018-05-31 10:35:07 +02:00
*/
2020-03-06 17:40:11 +01:00
function syncFragments( slide = currentSlide ) {
2020-03-09 18:51:07 +01:00
return config.sort( slide.querySelectorAll( '.fragment' ) );
2018-05-31 10:35:07 +02:00
}
2013-11-25 21:40:24 +01:00
/**
* Resets all vertical slides so that only the first
* is visible.
2013-11-25 21:40:24 +01:00
*/
function resetVerticalSlides() {
2013-11-25 21:40:24 +01:00
2020-03-07 11:58:18 +01:00
getHorizontalSlides().forEach( horizontalSlide => {
2013-11-25 21:40:24 +01:00
2020-03-06 17:40:11 +01:00
toArray( horizontalSlide.querySelectorAll( 'section' ) ).forEach( ( verticalSlide, y ) => {
2013-11-25 21:40:24 +01:00
if( y > 0 ) {
verticalSlide.classList.remove( 'present' );
verticalSlide.classList.remove( 'past' );
verticalSlide.classList.add( 'future' );
verticalSlide.setAttribute( 'aria-hidden', 'true' );
}
} );
} );
}
/**
* Randomly shuffles all slides in the deck.
*/
function shuffle() {
2020-03-06 17:40:11 +01:00
getHorizontalSlides().forEach( ( slide, i, slides ) => {
// Insert this slide next to another random slide. This may
// cause the slide to insert before itself but that's fine.
dom.slides.insertBefore( slide, slides[ Math.floor( Math.random() * slides.length ) ] );
} );
}
/**
* Updates one dimension of slides by showing the slide
* with the specified index.
*
2016-06-30 05:10:55 +02:00
* @param {string} selector A CSS selector that will fetch
* the group of slides we are working with
2016-06-30 05:10:55 +02:00
* @param {number} index The index of the slide that should be
* shown
*
2016-06-30 05:10:55 +02:00
* @return {number} The index of the slide that is now shown,
* might differ from the passed in index if it was out of
* bounds.
*/
function updateSlides( selector, index ) {
// Select all slides and convert the NodeList result to
// an array
2020-03-06 17:40:11 +01:00
let slides = toArray( dom.wrapper.querySelectorAll( selector ) ),
slidesLength = slides.length;
2020-03-06 17:40:11 +01:00
let printMode = isPrintingPDF();
if( slidesLength ) {
// Should the index loop?
if( config.loop ) {
index %= slidesLength;
if( index < 0 ) {
index = slidesLength + index;
}
}
// Enforce max and minimum index bounds
index = Math.max( Math.min( index, slidesLength - 1 ), 0 );
2020-03-06 17:40:11 +01:00
for( let i = 0; i < slidesLength; i++ ) {
let element = slides[i];
2020-03-06 17:40:11 +01:00
let reverse = config.rtl && !isVerticalSlide( element );
2020-03-06 17:40:11 +01:00
element.classList.remove( 'past', 'present', 'future' );
// http://www.w3.org/html/wg/drafts/html/master/editing.html#the-hidden-attribute
element.setAttribute( 'hidden', '' );
element.setAttribute( 'aria-hidden', 'true' );
// If this element contains vertical slides
if( element.querySelector( 'section' ) ) {
element.classList.add( 'stack' );
}
// If we're printing static slides, all slides are "present"
if( printMode ) {
element.classList.add( 'present' );
continue;
}
if( i < index ) {
// Any element previous to index is given the 'past' class
element.classList.add( reverse ? 'future' : 'past' );
2014-03-25 14:28:22 +01:00
if( config.fragments ) {
2018-10-11 11:32:16 +02:00
// Show all fragments in prior slides
2020-03-06 17:40:11 +01:00
toArray( element.querySelectorAll( '.fragment' ) ).forEach( fragment => {
2018-10-11 11:32:16 +02:00
fragment.classList.add( 'visible' );
fragment.classList.remove( 'current-fragment' );
} );
}
}
else if( i > index ) {
// Any element subsequent to index is given the 'future' class
element.classList.add( reverse ? 'past' : 'future' );
2014-03-25 14:28:22 +01:00
if( config.fragments ) {
2018-10-11 11:32:16 +02:00
// Hide all fragments in future slides
2020-03-06 17:40:11 +01:00
toArray( element.querySelectorAll( '.fragment.visible' ) ).forEach( fragment => {
fragment.classList.remove( 'visible', 'current-fragment' );
2018-10-11 11:32:16 +02:00
} );
}
}
}
// Mark the current slide as present
slides[index].classList.add( 'present' );
slides[index].removeAttribute( 'hidden' );
slides[index].removeAttribute( 'aria-hidden' );
// If this slide has a state associated with it, add it
// onto the current state of the deck
2020-03-06 17:40:11 +01:00
let slideState = slides[index].getAttribute( 'data-state' );
if( slideState ) {
state = state.concat( slideState.split( ' ' ) );
}
}
else {
// Since there are no slides we can't be anywhere beyond the
// zeroth index
index = 0;
}
return index;
}
/**
* Optimization method; hide all slides that are far away
* from the present slide.
*/
function updateSlidesVisibility() {
// Select all slides and convert the NodeList result to
// an array
2020-03-06 17:40:11 +01:00
let horizontalSlides = getHorizontalSlides(),
horizontalSlidesLength = horizontalSlides.length,
distanceX,
distanceY;
if( horizontalSlidesLength && typeof indexh !== 'undefined' ) {
// The number of steps away from the present slide that will
// be visible
2020-03-09 20:57:12 +01:00
let viewDistance = overview.isActive() ? 10 : config.viewDistance;
2019-12-09 21:05:41 +01:00
// Shorten the view distance on devices that typically have
// less resources
2020-03-09 18:51:07 +01:00
if( isMobile ) {
2020-03-09 20:57:12 +01:00
viewDistance = overview.isActive() ? 6 : config.mobileViewDistance;
}
// All slides need to be visible when exporting to PDF
if( isPrintingPDF() ) {
viewDistance = Number.MAX_VALUE;
}
2020-03-06 17:40:11 +01:00
for( let x = 0; x < horizontalSlidesLength; x++ ) {
let horizontalSlide = horizontalSlides[x];
2020-03-06 17:40:11 +01:00
let verticalSlides = toArray( horizontalSlide.querySelectorAll( 'section' ) ),
verticalSlidesLength = verticalSlides.length;
// Determine how far away this slide is from the present
distanceX = Math.abs( ( indexh || 0 ) - x ) || 0;
// If the presentation is looped, distance should measure
// 1 between the first and last slides
if( config.loop ) {
2015-02-09 09:35:05 +01:00
distanceX = Math.abs( ( ( indexh || 0 ) - x ) % ( horizontalSlidesLength - viewDistance ) ) || 0;
}
2013-08-18 06:01:28 +02:00
// Show the horizontal slide if it's within the view distance
if( distanceX < viewDistance ) {
slideContent.load( horizontalSlide );
}
else {
slideContent.unload( horizontalSlide );
}
2013-08-18 06:01:28 +02:00
if( verticalSlidesLength ) {
2020-03-06 17:40:11 +01:00
let oy = getPreviousVerticalIndex( horizontalSlide );
2020-03-06 17:40:11 +01:00
for( let y = 0; y < verticalSlidesLength; y++ ) {
let verticalSlide = verticalSlides[y];
distanceY = x === ( indexh || 0 ) ? Math.abs( ( indexv || 0 ) - y ) : Math.abs( y - oy );
if( distanceX + distanceY < viewDistance ) {
slideContent.load( verticalSlide );
}
else {
slideContent.unload( verticalSlide );
}
}
}
}
// Flag if there are ANY vertical slides, anywhere in the deck
if( hasVerticalSlides() ) {
dom.wrapper.classList.add( 'has-vertical-slides' );
}
else {
dom.wrapper.classList.remove( 'has-vertical-slides' );
}
// Flag if there are ANY horizontal slides, anywhere in the deck
if( hasHorizontalSlides() ) {
dom.wrapper.classList.add( 'has-horizontal-slides' );
}
else {
dom.wrapper.classList.remove( 'has-horizontal-slides' );
}
}
}
/**
2016-06-30 05:10:55 +02:00
* Pick up notes from the current slide and display them
* to the viewer.
*
2016-06-30 05:10:55 +02:00
* @see {@link config.showNotes}
*/
function updateNotes() {
if( config.showNotes && dom.speakerNotes && currentSlide && !isPrintingPDF() ) {
2017-05-18 16:03:20 +02:00
dom.speakerNotes.innerHTML = getSlideNotes() || '<span class="notes-placeholder">No notes on this slide.</span>';
}
}
/**
* Updates the visibility of the speaker notes sidebar that
* is used to share annotated slides. The notes sidebar is
* only visible if showNotes is true and there are notes on
* one or more slides in the deck.
*/
function updateNotesVisibility() {
if( config.showNotes && hasNotes() ) {
dom.wrapper.classList.add( 'show-notes' );
}
else {
dom.wrapper.classList.remove( 'show-notes' );
}
}
/**
* Checks if there are speaker notes for ANY slide in the
* presentation.
*/
function hasNotes() {
return dom.slides.querySelectorAll( '[data-notes], aside.notes' ).length > 0;
}
/**
* Updates the progress bar to reflect the current slide.
*/
function updateProgress() {
// Update progress if enabled
if( config.progress && dom.progressbar ) {
dom.progressbar.style.width = getProgress() * dom.wrapper.offsetWidth + 'px';
}
}
/**
2019-02-01 10:15:10 +01:00
* Updates the slide number to match the current slide.
*/
function updateSlideNumber() {
// Update slide number if enabled
if( config.slideNumber && dom.slideNumber ) {
2019-03-02 18:21:29 +01:00
dom.slideNumber.innerHTML = getSlideNumber();
}
2019-03-02 18:21:29 +01:00
}
2019-03-02 18:21:29 +01:00
/**
* Returns the HTML string corresponding to the current slide number,
* including formatting.
*/
2020-03-06 17:40:11 +01:00
function getSlideNumber( slide = currentSlide ) {
2020-03-06 17:40:11 +01:00
let value;
let format = 'h.v';
2019-03-02 18:21:29 +01:00
if ( typeof config.slideNumber === 'function' ) {
value = config.slideNumber( slide );
} else {
// Check if a custom number format is available
if( typeof config.slideNumber === 'string' ) {
format = config.slideNumber;
2015-10-29 10:58:06 +01:00
}
2019-03-02 18:21:29 +01:00
// If there are ONLY vertical slides in this deck, always use
// a flattened slide number
if( !/c/.test( format ) && dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR ).length === 1 ) {
format = 'c';
2015-10-29 10:58:06 +01:00
}
2019-03-02 18:21:29 +01:00
value = [];
switch( format ) {
case 'c':
value.push( getSlidePastCount( slide ) + 1 );
break;
case 'c/t':
value.push( getSlidePastCount( slide ) + 1, '/', getTotalSlides() );
break;
default:
2020-03-06 17:40:11 +01:00
let indices = getIndices( slide );
2019-03-02 18:21:29 +01:00
value.push( indices.h + 1 );
2020-03-06 17:40:11 +01:00
let sep = format === 'h/v' ? '/' : '.';
2019-03-02 18:21:29 +01:00
if( isVerticalSlide( slide ) ) value.push( sep, indices.v + 1 );
}
}
2020-03-06 17:40:11 +01:00
let url = '#' + locationHash( slide );
2019-03-02 18:21:29 +01:00
return formatSlideNumber( value[0], value[1], value[2], url );
}
/**
* Applies HTML formatting to a slide number before it's
* written to the DOM.
2016-06-30 05:10:55 +02:00
*
* @param {number} a Current slide
* @param {string} delimiter Character to separate slide numbers
* @param {(number|*)} b Total slides
2019-03-02 18:21:29 +01:00
* @param {HTMLElement} [url='#'+locationHash()] The url to link to
2016-06-30 05:10:55 +02:00
* @return {string} HTML string fragment
*/
2020-03-06 17:40:11 +01:00
function formatSlideNumber( a, delimiter, b, url = '#' + locationHash() ) {
if( typeof b === 'number' && !isNaN( b ) ) {
2020-03-06 17:40:11 +01:00
return `<a href="${url}">
<span class="slide-number-a">${a}</span>
<span class="slide-number-delimiter">${delimiter}</span>
<span class="slide-number-b">${b}</span>
</a>`;
}
else {
2020-03-06 17:40:11 +01:00
return `<a href="${url}">
<span class="slide-number-a">${a}</span>
</a>`;
}
}
/**
* Updates the state of all control/navigation arrows.
*/
function updateControls() {
2020-03-06 17:40:11 +01:00
let routes = availableRoutes();
2020-03-09 18:51:07 +01:00
let fragmentsRoutes = fragments.availableRoutes();
// Remove the 'enabled' class from all directions
2020-03-06 17:40:11 +01:00
[...dom.controlsLeft, ...dom.controlsRight, ...dom.controlsUp, ...dom.controlsDown, ...dom.controlsPrev, ...dom.controlsNext].forEach( node => {
node.classList.remove( 'enabled', 'fragmented' );
2016-05-23 10:54:40 +02:00
// Set 'disabled' attribute on all directions
2016-05-23 10:54:40 +02:00
node.setAttribute( 'disabled', 'disabled' );
} );
// Add the 'enabled' class to the available routes; remove 'disabled' attribute to enable buttons
2020-03-06 17:40:11 +01:00
if( routes.left ) dom.controlsLeft.forEach( el => { el.classList.add( 'enabled' ); el.removeAttribute( 'disabled' ); } );
if( routes.right ) dom.controlsRight.forEach( el => { el.classList.add( 'enabled' ); el.removeAttribute( 'disabled' ); } );
if( routes.up ) dom.controlsUp.forEach( el => { el.classList.add( 'enabled' ); el.removeAttribute( 'disabled' ); } );
if( routes.down ) dom.controlsDown.forEach( el => { el.classList.add( 'enabled' ); el.removeAttribute( 'disabled' ); } );
// Prev/next buttons
2020-03-06 17:40:11 +01:00
if( routes.left || routes.up ) dom.controlsPrev.forEach( el => { el.classList.add( 'enabled' ); el.removeAttribute( 'disabled' ); } );
if( routes.right || routes.down ) dom.controlsNext.forEach( el => { el.classList.add( 'enabled' ); el.removeAttribute( 'disabled' ); } );
// Highlight fragment directions
if( currentSlide ) {
// Always apply fragment decorator to prev/next buttons
2020-03-09 18:51:07 +01:00
if( fragmentsRoutes.prev ) dom.controlsPrev.forEach( el => { el.classList.add( 'fragmented', 'enabled' ); el.removeAttribute( 'disabled' ); } );
if( fragmentsRoutes.next ) dom.controlsNext.forEach( el => { el.classList.add( 'fragmented', 'enabled' ); el.removeAttribute( 'disabled' ); } );
// Apply fragment decorators to directional buttons based on
// what slide axis they are in
if( isVerticalSlide( currentSlide ) ) {
2020-03-09 18:51:07 +01:00
if( fragmentsRoutes.prev ) dom.controlsUp.forEach( el => { el.classList.add( 'fragmented', 'enabled' ); el.removeAttribute( 'disabled' ); } );
if( fragmentsRoutes.next ) dom.controlsDown.forEach( el => { el.classList.add( 'fragmented', 'enabled' ); el.removeAttribute( 'disabled' ); } );
}
else {
2020-03-09 18:51:07 +01:00
if( fragmentsRoutes.prev ) dom.controlsLeft.forEach( el => { el.classList.add( 'fragmented', 'enabled' ); el.removeAttribute( 'disabled' ); } );
if( fragmentsRoutes.next ) dom.controlsRight.forEach( el => { el.classList.add( 'fragmented', 'enabled' ); el.removeAttribute( 'disabled' ); } );
}
2012-06-10 11:53:44 +02:00
}
2017-05-16 15:40:50 +02:00
if( config.controlsTutorial ) {
// Highlight control arrows with an animation to ensure
// that the viewer knows how to navigate
2020-02-06 15:19:09 +01:00
if( !hasNavigatedVertically && routes.down ) {
dom.controlsDownArrow.classList.add( 'highlight' );
}
else {
dom.controlsDownArrow.classList.remove( 'highlight' );
2020-02-06 15:19:09 +01:00
if( config.rtl ) {
2020-02-06 15:19:09 +01:00
if( !hasNavigatedHorizontally && routes.left && indexv === 0 ) {
dom.controlsLeftArrow.classList.add( 'highlight' );
}
else {
dom.controlsLeftArrow.classList.remove( 'highlight' );
}
} else {
2020-02-06 15:19:09 +01:00
if( !hasNavigatedHorizontally && routes.right && indexv === 0 ) {
dom.controlsRightArrow.classList.add( 'highlight' );
}
else {
dom.controlsRightArrow.classList.remove( 'highlight' );
}
}
}
}
}
/**
* Updates the background elements to reflect the current
* slide.
*
2016-06-30 05:10:55 +02:00
* @param {boolean} includeAll If true, the backgrounds of
* all vertical slides (not just the present) will be updated.
*/
2020-03-06 17:40:11 +01:00
function updateBackground( includeAll = false ) {
2020-03-06 17:40:11 +01:00
let currentBackground = null;
// Reverse past/future classes when in RTL mode
2020-03-06 17:40:11 +01:00
let horizontalPast = config.rtl ? 'future' : 'past',
horizontalFuture = config.rtl ? 'past' : 'future';
// Update the classes of all backgrounds to match the
// states of their slides (past/present/future)
2020-03-06 17:40:11 +01:00
toArray( dom.background.childNodes ).forEach( ( backgroundh, h ) => {
2020-03-06 17:40:11 +01:00
backgroundh.classList.remove( 'past', 'present', 'future' );
if( h < indexh ) {
backgroundh.classList.add( horizontalPast );
}
else if ( h > indexh ) {
backgroundh.classList.add( horizontalFuture );
}
else {
backgroundh.classList.add( 'present' );
// Store a reference to the current background element
currentBackground = backgroundh;
}
if( includeAll || h === indexh ) {
2020-03-06 17:40:11 +01:00
toArray( backgroundh.querySelectorAll( '.slide-background' ) ).forEach( ( backgroundv, v ) => {
2020-03-06 17:40:11 +01:00
backgroundv.classList.remove( 'past', 'present', 'future' );
if( v < indexv ) {
backgroundv.classList.add( 'past' );
}
else if ( v > indexv ) {
backgroundv.classList.add( 'future' );
}
else {
backgroundv.classList.add( 'present' );
// Only if this is the present horizontal and vertical slide
if( h === indexh ) currentBackground = backgroundv;
}
} );
}
} );
// Stop content inside of previous backgrounds
2014-04-04 09:22:15 +02:00
if( previousBackground ) {
2020-03-09 18:51:07 +01:00
slideContent.stopEmbeddedContent( previousBackground, { unloadIframes: !slideContent.shouldPreload( previousBackground ) } );
2014-04-04 09:22:15 +02:00
}
// Start content in the current background
if( currentBackground ) {
2014-04-04 09:22:15 +02:00
slideContent.startEmbeddedContent( currentBackground );
2014-04-04 09:22:15 +02:00
2020-03-06 17:40:11 +01:00
let currentBackgroundContent = currentBackground.querySelector( '.slide-background-content' );
if( currentBackgroundContent ) {
2020-03-06 17:40:11 +01:00
let backgroundImageURL = currentBackgroundContent.style.backgroundImage || '';
// Restart GIFs (doesn't work in Firefox)
if( /\.gif/i.test( backgroundImageURL ) ) {
currentBackgroundContent.style.backgroundImage = '';
window.getComputedStyle( currentBackgroundContent ).opacity;
currentBackgroundContent.style.backgroundImage = backgroundImageURL;
}
}
2014-04-04 09:22:15 +02:00
// Don't transition between identical backgrounds. This
// prevents unwanted flicker.
2020-03-06 17:40:11 +01:00
let previousBackgroundHash = previousBackground ? previousBackground.getAttribute( 'data-background-hash' ) : null;
let currentBackgroundHash = currentBackground.getAttribute( 'data-background-hash' );
if( currentBackgroundHash && currentBackgroundHash === previousBackgroundHash && currentBackground !== previousBackground ) {
dom.background.classList.add( 'no-transition' );
}
previousBackground = currentBackground;
2014-04-04 09:22:15 +02:00
}
2014-09-10 10:12:25 +02:00
// If there's a background brightness flag for this slide,
// bubble it to the .reveal container
if( currentSlide ) {
2020-03-06 17:40:11 +01:00
[ 'has-light-background', 'has-dark-background' ].forEach( classToBubble => {
2014-09-10 10:12:25 +02:00
if( currentSlide.classList.contains( classToBubble ) ) {
dom.wrapper.classList.add( classToBubble );
}
else {
dom.wrapper.classList.remove( classToBubble );
}
} );
}
// Allow the first background to apply without transition
2020-03-06 17:40:11 +01:00
setTimeout( () => {
dom.background.classList.remove( 'no-transition' );
}, 1 );
}
/**
* Updates the position of the parallax background based
* on the current slide index.
*/
function updateParallax() {
if( config.parallaxBackgroundImage ) {
2020-03-06 17:40:11 +01:00
let horizontalSlides = getHorizontalSlides(),
verticalSlides = getVerticalSlides();
2020-03-06 17:40:11 +01:00
let backgroundSize = dom.background.style.backgroundSize.split( ' ' ),
backgroundWidth, backgroundHeight;
if( backgroundSize.length === 1 ) {
backgroundWidth = backgroundHeight = parseInt( backgroundSize[0], 10 );
}
else {
backgroundWidth = parseInt( backgroundSize[0], 10 );
backgroundHeight = parseInt( backgroundSize[1], 10 );
}
2020-03-06 17:40:11 +01:00
let slideWidth = dom.background.offsetWidth,
horizontalSlideCount = horizontalSlides.length,
horizontalOffsetMultiplier,
horizontalOffset;
if( typeof config.parallaxBackgroundHorizontal === 'number' ) {
horizontalOffsetMultiplier = config.parallaxBackgroundHorizontal;
}
else {
2015-11-19 10:38:52 +01:00
horizontalOffsetMultiplier = horizontalSlideCount > 1 ? ( backgroundWidth - slideWidth ) / ( horizontalSlideCount-1 ) : 0;
}
horizontalOffset = horizontalOffsetMultiplier * indexh * -1;
2020-03-06 17:40:11 +01:00
let slideHeight = dom.background.offsetHeight,
verticalSlideCount = verticalSlides.length,
verticalOffsetMultiplier,
verticalOffset;
if( typeof config.parallaxBackgroundVertical === 'number' ) {
verticalOffsetMultiplier = config.parallaxBackgroundVertical;
}
else {
verticalOffsetMultiplier = ( backgroundHeight - slideHeight ) / ( verticalSlideCount-1 );
}
2016-06-30 05:10:55 +02:00
verticalOffset = verticalSlideCount > 0 ? verticalOffsetMultiplier * indexv : 0;
dom.background.style.backgroundPosition = horizontalOffset + 'px ' + -verticalOffset + 'px';
}
}
2020-01-31 10:46:28 +01:00
/**
2011-12-05 03:55:48 +01:00
* Determine what available routes there are for navigation.
2020-01-31 10:46:28 +01:00
*
2016-06-30 05:10:55 +02:00
* @return {{left: boolean, right: boolean, up: boolean, down: boolean}}
2020-01-31 10:46:28 +01:00
*/
function availableRoutes() {
2020-03-07 11:58:18 +01:00
let horizontalSlides = dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR ),
verticalSlides = dom.wrapper.querySelectorAll( VERTICAL_SLIDES_SELECTOR );
2020-03-06 17:40:11 +01:00
let routes = {
left: indexh > 0,
right: indexh < horizontalSlides.length - 1,
up: indexv > 0,
down: indexv < verticalSlides.length - 1
};
// Looped presentations can always be navigated as long as
// there are slides available
if( config.loop ) {
if( horizontalSlides.length > 1 ) {
routes.left = true;
routes.right = true;
}
2020-01-31 10:46:28 +01:00
if( verticalSlides.length > 1 ) {
routes.up = true;
routes.down = true;
}
}
2020-01-31 10:46:28 +01:00
// Reverse horizontal controls for rtl
if( config.rtl ) {
2020-03-06 17:40:11 +01:00
let left = routes.left;
routes.left = routes.right;
routes.right = left;
}
return routes;
}
2020-01-31 10:46:28 +01:00
/**
* Returns the number of past slides. This can be used as a global
* flattened index for slides.
2016-06-30 05:10:55 +02:00
*
* @param {HTMLElement} [slide=currentSlide] The slide we're counting before
2020-01-31 10:46:28 +01:00
*
2016-06-30 05:10:55 +02:00
* @return {number} Past slide count
2020-01-31 10:46:28 +01:00
*/
2020-03-06 17:40:11 +01:00
function getSlidePastCount( slide = currentSlide ) {
2020-01-31 10:46:28 +01:00
2020-03-06 17:40:11 +01:00
let horizontalSlides = getHorizontalSlides();
// The number of past slides
2020-03-06 17:40:11 +01:00
let pastCount = 0;
2014-03-12 22:26:31 +01:00
// Step through all slides and count the past ones
2020-03-06 17:40:11 +01:00
mainLoop: for( let i = 0; i < horizontalSlides.length; i++ ) {
2020-03-06 17:40:11 +01:00
let horizontalSlide = horizontalSlides[i];
let verticalSlides = horizontalSlide.querySelectorAll( 'section' );
2020-01-31 10:46:28 +01:00
2020-03-06 17:40:11 +01:00
for( let j = 0; j < verticalSlides.length; j++ ) {
2014-03-12 22:26:31 +01:00
// Stop as soon as we arrive at the present
if( verticalSlides[j] === slide ) {
2014-03-12 22:26:31 +01:00
break mainLoop;
}
// Don't count slides with the "uncounted" class
if( verticalSlides[j].dataset.visibility !== 'uncounted' ) {
pastCount++;
}
2014-03-12 22:26:31 +01:00
}
// Stop as soon as we arrive at the present
if( horizontalSlide === slide ) {
2014-03-12 22:26:31 +01:00
break;
}
// Don't count the wrapping section for vertical slides and
// slides marked as uncounted
if( horizontalSlide.classList.contains( 'stack' ) === false && !horizontalSlide.dataset.visibility !== 'uncounted' ) {
2014-03-12 22:26:31 +01:00
pastCount++;
}
}
return pastCount;
}
/**
* Returns a value ranging from 0-1 that represents
* how far into the presentation we have navigated.
2016-06-30 05:10:55 +02:00
*
* @return {number}
*/
function getProgress() {
// The number of past and total slides
2020-03-06 17:40:11 +01:00
let totalCount = getTotalSlides();
let pastCount = getSlidePastCount();
if( currentSlide ) {
2020-03-06 17:40:11 +01:00
let allFragments = currentSlide.querySelectorAll( '.fragment' );
// If there are fragments in the current slide those should be
// accounted for in the progress.
if( allFragments.length > 0 ) {
2020-03-06 17:40:11 +01:00
let visibleFragments = currentSlide.querySelectorAll( '.fragment.visible' );
// This value represents how big a portion of the slide progress
// that is made up by its fragments (0-1)
2020-03-06 17:40:11 +01:00
let fragmentWeight = 0.9;
// Add fragment progress to the past slide count
pastCount += ( visibleFragments.length / allFragments.length ) * fragmentWeight;
}
}
return Math.min( pastCount / ( totalCount - 1 ), 1 );
2014-03-12 22:26:31 +01:00
}
/**
* Checks if this presentation is running inside of the
* speaker notes window.
2016-06-30 05:10:55 +02:00
*
* @return {boolean}
*/
function isSpeakerNotes() {
return !!window.location.search.match( /receiver/gi );
}
2011-06-07 21:10:59 +02:00
/**
* Reads the current URL (hash) and navigates accordingly.
*/
function readURL() {
2020-03-06 17:40:11 +01:00
let hash = window.location.hash;
2012-08-21 04:13:00 +02:00
// Attempt to parse the hash as either an index or name
2020-03-06 17:40:11 +01:00
let bits = hash.slice( 2 ).split( '/' ),
2012-08-21 04:13:00 +02:00
name = hash.replace( /#|\//gi, '' );
// If the first bit is not fully numeric and there is a name we
// can assume that this is a named link
if( !/^[0-9]*$/.test( bits[0] ) && name.length ) {
2020-03-06 17:40:11 +01:00
let element;
// Ensure the named link is a valid HTML ID attribute
2017-11-17 11:59:21 +01:00
try {
element = document.getElementById( decodeURIComponent( name ) );
}
2018-03-22 11:58:15 +01:00
catch ( error ) { }
2012-08-21 04:13:00 +02:00
2018-03-27 14:21:41 +02:00
// Ensure that we're not already on a slide with the same name
2020-03-06 17:40:11 +01:00
let isSameNameAsCurrentSlide = currentSlide ? currentSlide.getAttribute( 'id' ) === name : false;
2012-08-21 04:13:00 +02:00
if( element ) {
// If the slide exists and is not the current slide...
if ( !isSameNameAsCurrentSlide ) {
// ...find the position of the named slide and navigate to it
2020-03-06 17:40:11 +01:00
let indices = Reveal.getIndices(element);
slide(indices.h, indices.v);
}
2012-08-21 04:13:00 +02:00
}
// If the slide doesn't exist, navigate to the current slide
else {
slide( indexh || 0, indexv || 0 );
2012-08-21 04:13:00 +02:00
}
}
else {
2020-03-06 17:40:11 +01:00
let hashIndexBase = config.hashOneBasedIndex ? 1 : 0;
2012-08-21 04:13:00 +02:00
// Read the index components of the hash
2020-03-06 17:40:11 +01:00
let h = ( parseInt( bits[0], 10 ) - hashIndexBase ) || 0,
v = ( parseInt( bits[1], 10 ) - hashIndexBase ) || 0,
2018-01-04 21:09:01 +01:00
f;
2018-01-04 21:09:01 +01:00
if( config.fragmentInURL ) {
f = parseInt( bits[2], 10 );
if( isNaN( f ) ) {
f = undefined;
}
2018-01-04 21:09:01 +01:00
}
2018-01-04 21:09:01 +01:00
if( h !== indexh || v !== indexv || f !== undefined ) {
slide( h, v, f );
}
2012-08-21 04:13:00 +02:00
}
2011-06-07 21:10:59 +02:00
}
2011-06-07 21:10:59 +02:00
/**
* Updates the page URL (hash) to reflect the current
* state.
*
2016-06-30 05:10:55 +02:00
* @param {number} delay The time in ms to wait before
* writing the hash
2011-06-07 21:10:59 +02:00
*/
function writeURL( delay ) {
// Make sure there's never more than one timeout running
clearTimeout( writeURLTimeout );
// If a delay is specified, timeout this call
if( typeof delay === 'number' ) {
writeURLTimeout = setTimeout( writeURL, delay );
}
else if( currentSlide ) {
2019-03-21 09:13:28 +01:00
// If we're configured to push to history OR the history
// API is not avaialble.
if( config.history || !window.history ) {
window.location.hash = locationHash();
}
2019-04-01 13:11:29 +02:00
// If we're configured to reflect the current slide in the
2019-03-21 09:13:28 +01:00
// URL without pushing to history.
else if( config.hash ) {
2019-03-21 09:13:28 +01:00
window.history.replaceState( null, null, '#' + locationHash() );
}
// If history and hash are both disabled, a hash may still
// be added to the URL by clicking on a href with a hash
// target. Counter this by always removing the hash.
else {
window.history.replaceState( null, null, window.location.pathname + window.location.search );
}
}
2011-06-07 21:10:59 +02:00
}
/**
2016-06-30 05:10:55 +02:00
* Retrieves the h/v location and fragment of the current,
* or specified, slide.
*
2016-06-30 05:10:55 +02:00
* @param {HTMLElement} [slide] If specified, the returned
* index will be for this slide rather than the currently
* active one
*
2016-06-30 05:10:55 +02:00
* @return {{h: number, v: number, f: number}}
*/
function getIndices( slide ) {
// By default, return the current indices
2020-03-06 17:40:11 +01:00
let h = indexh,
v = indexv,
f;
// If a slide is specified, return the indices of that slide
if( slide ) {
2020-03-06 17:40:11 +01:00
let isVertical = isVerticalSlide( slide );
let slideh = isVertical ? slide.parentNode : slide;
// Select all horizontal slides
2020-03-06 17:40:11 +01:00
let horizontalSlides = toArray( dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR ) );
// Now that we know which the horizontal slide is, get its index
h = Math.max( horizontalSlides.indexOf( slideh ), 0 );
2014-04-27 15:39:11 +02:00
// Assume we're not vertical
v = undefined;
2014-04-27 15:39:11 +02:00
// If this is a vertical slide, grab the vertical index
if( isVertical ) {
v = Math.max( toArray( slide.parentNode.querySelectorAll( 'section' ) ).indexOf( slide ), 0 );
}
}
if( !slide && currentSlide ) {
2020-03-06 17:40:11 +01:00
let hasFragments = currentSlide.querySelectorAll( '.fragment' ).length > 0;
if( hasFragments ) {
2020-03-06 17:40:11 +01:00
let currentFragment = currentSlide.querySelector( '.current-fragment' );
if( currentFragment && currentFragment.hasAttribute( 'data-fragment-index' ) ) {
f = parseInt( currentFragment.getAttribute( 'data-fragment-index' ), 10 );
}
else {
f = currentSlide.querySelectorAll( '.fragment.visible' ).length - 1;
}
}
}
2020-03-06 17:40:11 +01:00
return { h, v, f };
}
/**
* Retrieves all slides in this presentation.
*/
function getSlides() {
return toArray( dom.wrapper.querySelectorAll( SLIDES_SELECTOR + ':not(.stack):not([data-visibility="uncounted"])' ) );
}
/**
* Returns a list of all horizontal slides in the deck. Each
* vertical stack is included as one horizontal slide in the
* resulting array.
*/
function getHorizontalSlides() {
return toArray( dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR ) );
}
/**
* Returns all vertical slides that exist within this deck.
*/
function getVerticalSlides() {
return toArray( dom.wrapper.querySelectorAll( '.slides>section>section' ) );
}
2020-03-06 14:54:55 +01:00
/**
* Returns all vertical stacks (each stack can contain multiple slides).
*/
function getVerticalStacks() {
return toArray( dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.stack') );
}
/**
* Returns true if there are at least two horizontal slides.
*/
function hasHorizontalSlides() {
return getHorizontalSlides().length > 1;
}
/**
* Returns true if there are at least two vertical slides.
*/
function hasVerticalSlides() {
return getVerticalSlides().length > 1;
}
2018-02-20 10:30:56 +01:00
/**
2018-10-04 13:26:16 +02:00
* Returns an array of objects where each object represents the
* attributes on its respective slide.
2018-02-20 10:30:56 +01:00
*/
2018-10-04 13:26:16 +02:00
function getSlidesAttributes() {
2020-03-07 11:58:18 +01:00
return getSlides().map( slide => {
2018-10-04 13:26:16 +02:00
2020-03-06 17:40:11 +01:00
let attributes = {};
for( let i = 0; i < slide.attributes.length; i++ ) {
let attribute = slide.attributes[ i ];
2018-10-04 13:26:16 +02:00
attributes[ attribute.name ] = attribute.value;
}
2018-10-04 13:26:16 +02:00
return attributes;
} );
}
2014-04-01 09:12:41 +02:00
/**
* Retrieves the total number of slides in this presentation.
2016-06-30 05:10:55 +02:00
*
* @return {number}
2014-04-01 09:12:41 +02:00
*/
function getTotalSlides() {
return getSlides().length;
2014-04-01 09:12:41 +02:00
}
/**
* Returns the slide element matching the specified index.
2016-06-30 05:10:55 +02:00
*
* @return {HTMLElement}
*/
2014-04-27 14:46:49 +02:00
function getSlide( x, y ) {
2020-03-06 17:40:11 +01:00
let horizontalSlide = getHorizontalSlides()[ x ];
let verticalSlides = horizontalSlide && horizontalSlide.querySelectorAll( 'section' );
2014-04-27 14:46:49 +02:00
if( verticalSlides && verticalSlides.length && typeof y === 'number' ) {
2014-04-27 14:46:49 +02:00
return verticalSlides ? verticalSlides[ y ] : undefined;
}
return horizontalSlide;
}
/**
* Returns the background element for the given slide.
* All slides, even the ones with no background properties
* defined, have a background element so as long as the
* index is valid an element will be returned.
2016-06-30 05:10:55 +02:00
*
* @param {mixed} x Horizontal background index OR a slide
* HTML element
2016-06-30 05:10:55 +02:00
* @param {number} y Vertical background index
* @return {(HTMLElement[]|*)}
2014-04-27 14:46:49 +02:00
*/
function getSlideBackground( x, y ) {
2020-03-06 17:40:11 +01:00
let slide = typeof x === 'number' ? getSlide( x, y ) : x;
if( slide ) {
return slide.slideBackgroundElement;
2014-04-27 14:46:49 +02:00
}
return undefined;
2014-04-27 14:46:49 +02:00
}
2015-09-10 08:28:52 +02:00
/**
* Retrieves the speaker notes from a slide. Notes can be
* defined in two ways:
* 1. As a data-notes attribute on the slide <section>
* 2. As an <aside class="notes"> inside of the slide
2016-06-30 05:10:55 +02:00
*
* @param {HTMLElement} [slide=currentSlide]
* @return {(string|null)}
2015-09-10 08:28:52 +02:00
*/
2020-03-06 17:40:11 +01:00
function getSlideNotes( slide = currentSlide ) {
2015-09-10 08:28:52 +02:00
// Notes can be specified via the data-notes attribute...
if( slide.hasAttribute( 'data-notes' ) ) {
return slide.getAttribute( 'data-notes' );
}
// ... or using an <aside class="notes"> element
2020-03-06 17:40:11 +01:00
let notesElement = slide.querySelector( 'aside.notes' );
2015-09-10 08:28:52 +02:00
if( notesElement ) {
return notesElement.innerHTML;
}
return null;
}
/**
* Retrieves the current state of the presentation as
* an object. This state can then be restored at any
* time.
2016-06-30 05:10:55 +02:00
*
* @return {{indexh: number, indexv: number, indexf: number, paused: boolean, overview: boolean}}
*/
function getState() {
2020-03-06 17:40:11 +01:00
let indices = getIndices();
return {
indexh: indices.h,
indexv: indices.v,
indexf: indices.f,
paused: isPaused(),
2020-03-09 20:57:12 +01:00
overview: overview.isActive()
};
}
/**
* Restores the presentation to the given state.
*
2016-06-30 05:10:55 +02:00
* @param {object} state As generated by getState()
* @see {@link getState} generates the parameter `state`
*/
function setState( state ) {
if( typeof state === 'object' ) {
2014-03-12 08:51:51 +01:00
slide( deserialize( state.indexh ), deserialize( state.indexv ), deserialize( state.indexf ) );
2020-03-07 11:58:18 +01:00
let pausedFlag = deserialize( state.paused ),
overviewFlag = deserialize( state.overview );
if( typeof pausedFlag === 'boolean' && pausedFlag !== isPaused() ) {
togglePause( pausedFlag );
}
2020-03-09 20:57:12 +01:00
if( typeof overviewFlag === 'boolean' && overviewFlag !== overview.isActive() ) {
overview.toggle( overviewFlag );
}
}
}
/**
* Cues a new automated slide if enabled in the config.
*/
function cueAutoSlide() {
cancelAutoSlide();
if( currentSlide && config.autoSlide !== false ) {
2020-03-06 17:40:11 +01:00
let fragment = currentSlide.querySelector( '.current-fragment' );
// When the slide first appears there is no "current" fragment so
// we look for a data-autoslide timing on the first fragment
if( !fragment ) fragment = currentSlide.querySelector( '.fragment' );
2020-03-06 17:40:11 +01:00
let fragmentAutoSlide = fragment ? fragment.getAttribute( 'data-autoslide' ) : null;
let parentAutoSlide = currentSlide.parentNode ? currentSlide.parentNode.getAttribute( 'data-autoslide' ) : null;
let slideAutoSlide = currentSlide.getAttribute( 'data-autoslide' );
2013-11-07 15:15:56 +01:00
// Pick value in the following priority order:
// 1. Current fragment's data-autoslide
// 2. Current slide's data-autoslide
// 3. Parent slide's data-autoslide
// 4. Global autoSlide setting
if( fragmentAutoSlide ) {
autoSlide = parseInt( fragmentAutoSlide, 10 );
}
else if( slideAutoSlide ) {
autoSlide = parseInt( slideAutoSlide, 10 );
}
else if( parentAutoSlide ) {
autoSlide = parseInt( parentAutoSlide, 10 );
}
else {
autoSlide = config.autoSlide;
}
// If there are media elements with data-autoplay,
// automatically set the autoSlide duration to the
2015-03-25 15:48:10 +01:00
// length of that media. Not applicable if the slide
// is divided up into fragments.
// playbackRate is accounted for in the duration.
2015-03-25 15:48:10 +01:00
if( currentSlide.querySelectorAll( '.fragment' ).length === 0 ) {
2020-03-06 17:40:11 +01:00
toArray( currentSlide.querySelectorAll( 'video, audio' ) ).forEach( el => {
2015-03-25 15:48:10 +01:00
if( el.hasAttribute( 'data-autoplay' ) ) {
if( autoSlide && (el.duration * 1000 / el.playbackRate ) > autoSlide ) {
autoSlide = ( el.duration * 1000 / el.playbackRate ) + 1000;
2015-03-25 15:48:10 +01:00
}
}
2015-03-25 15:48:10 +01:00
} );
}
// Cue the next auto-slide if:
// - There is an autoSlide value
// - Auto-sliding isn't paused by the user
// - The presentation isn't paused
// - The overview isn't active
// - The presentation isn't over
2020-03-09 20:57:12 +01:00
if( autoSlide && !autoSlidePaused && !isPaused() && !overview.isActive() && ( !isLastSlide() || fragments.availableRoutes().next || config.loop === true ) ) {
2020-03-06 17:40:11 +01:00
autoSlideTimeout = setTimeout( () => {
if( typeof config.autoSlideMethod === 'function' ) {
config.autoSlideMethod()
}
else {
navigateNext();
}
cueAutoSlide();
}, autoSlide );
autoSlideStartTime = Date.now();
}
if( autoSlidePlayer ) {
autoSlidePlayer.setPlaying( autoSlideTimeout !== -1 );
}
}
}
/**
* Cancels any ongoing request to auto-slide.
*/
function cancelAutoSlide() {
clearTimeout( autoSlideTimeout );
autoSlideTimeout = -1;
}
function pauseAutoSlide() {
if( autoSlide && !autoSlidePaused ) {
autoSlidePaused = true;
dispatchEvent( 'autoslidepaused' );
clearTimeout( autoSlideTimeout );
if( autoSlidePlayer ) {
autoSlidePlayer.setPlaying( false );
}
}
}
function resumeAutoSlide() {
if( autoSlide && autoSlidePaused ) {
autoSlidePaused = false;
dispatchEvent( 'autoslideresumed' );
cueAutoSlide();
}
}
2011-06-07 21:10:59 +02:00
function navigateLeft() {
2020-02-06 15:19:09 +01:00
hasNavigatedHorizontally = true;
// Reverse for RTL
if( config.rtl ) {
2020-03-09 20:57:12 +01:00
if( ( overview.isActive() || fragments.next() === false ) && availableRoutes().left ) {
slide( indexh + 1, config.navigationMode === 'grid' ? indexv : undefined );
}
}
// Normal navigation
2020-03-09 20:57:12 +01:00
else if( ( overview.isActive() || fragments.prev() === false ) && availableRoutes().left ) {
slide( indexh - 1, config.navigationMode === 'grid' ? indexv : undefined );
}
2011-06-07 21:10:59 +02:00
}
2011-06-07 21:10:59 +02:00
function navigateRight() {
2020-02-06 15:19:09 +01:00
hasNavigatedHorizontally = true;
// Reverse for RTL
if( config.rtl ) {
2020-03-09 20:57:12 +01:00
if( ( overview.isActive() || fragments.prev() === false ) && availableRoutes().right ) {
slide( indexh - 1, config.navigationMode === 'grid' ? indexv : undefined );
}
}
// Normal navigation
2020-03-09 20:57:12 +01:00
else if( ( overview.isActive() || fragments.next() === false ) && availableRoutes().right ) {
slide( indexh + 1, config.navigationMode === 'grid' ? indexv : undefined );
}
2011-06-07 21:10:59 +02:00
}
2011-06-07 21:10:59 +02:00
function navigateUp() {
// Prioritize hiding fragments
2020-03-09 20:57:12 +01:00
if( ( overview.isActive() || fragments.prev() === false ) && availableRoutes().up ) {
slide( indexh, indexv - 1 );
}
2011-06-07 21:10:59 +02:00
}
2011-06-07 21:10:59 +02:00
function navigateDown() {
2020-02-06 15:19:09 +01:00
hasNavigatedVertically = true;
// Prioritize revealing fragments
2020-03-09 20:57:12 +01:00
if( ( overview.isActive() || fragments.next() === false ) && availableRoutes().down ) {
slide( indexh, indexv + 1 );
}
2011-06-07 21:10:59 +02:00
}
/**
* Navigates backwards, prioritized in the following order:
* 1) Previous fragment
* 2) Previous vertical slide
* 3) Previous horizontal slide
*/
function navigatePrev() {
// Prioritize revealing fragments
2020-03-09 18:51:07 +01:00
if( fragments.prev() === false ) {
if( availableRoutes().up ) {
navigateUp();
}
else {
2014-10-16 16:17:41 +02:00
// Fetch the previous horizontal slide, if there is one
2020-03-06 17:40:11 +01:00
let previousSlide;
2014-10-16 16:17:41 +02:00
if( config.rtl ) {
2014-10-16 16:17:41 +02:00
previousSlide = toArray( dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.future' ) ).pop();
}
else {
previousSlide = toArray( dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR + '.past' ) ).pop();
}
if( previousSlide ) {
2020-03-06 17:40:11 +01:00
let v = ( previousSlide.querySelectorAll( 'section' ).length - 1 ) || undefined;
let h = indexh - 1;
2014-10-16 16:17:41 +02:00
slide( h, v );
}
}
}
}
/**
2014-10-16 16:17:41 +02:00
* The reverse of #navigatePrev().
*/
function navigateNext() {
2020-02-06 15:19:09 +01:00
hasNavigatedHorizontally = true;
hasNavigatedVertically = true;
// Prioritize revealing fragments
2020-03-09 18:51:07 +01:00
if( fragments.next() === false ) {
2020-03-06 17:40:11 +01:00
let routes = availableRoutes();
// When looping is enabled `routes.down` is always available
// so we need a separate check for when we've reached the
// end of a stack and should move horizontally
2020-03-09 20:57:12 +01:00
if( routes.down && routes.right && config.loop && isLastVerticalSlide( currentSlide ) ) {
routes.down = false;
}
if( routes.down ) {
2014-10-16 16:17:41 +02:00
navigateDown();
}
else if( config.rtl ) {
navigateLeft();
}
else {
navigateRight();
2014-10-11 17:59:36 +02:00
}
}
}
2015-09-10 11:25:19 +02:00
/**
* Checks if the target element prevents the triggering of
* swipe navigation.
*/
function isSwipePrevented( target ) {
while( target && typeof target.hasAttribute === 'function' ) {
if( target.hasAttribute( 'data-prevent-swipe' ) ) return true;
target = target.parentNode;
}
return false;
}
// --------------------------------------------------------------------//
// ----------------------------- EVENTS -------------------------------//
// --------------------------------------------------------------------//
/**
* Called by all event handlers that are based on user
* input.
2016-06-30 05:10:55 +02:00
*
* @param {object} [event]
*/
function onUserInput( event ) {
if( config.autoSlideStoppable ) {
pauseAutoSlide();
}
}
/**
* Called whenever there is mouse input at the document level
* to determine if the cursor is active or not.
*
* @param {object} event
*/
function onDocumentCursorActive( event ) {
showCursor();
clearTimeout( cursorInactiveTimeout );
cursorInactiveTimeout = setTimeout( hideCursor, config.hideCursorTime );
}
/**
* Handler for the document level 'keypress' event.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onDocumentKeyPress( event ) {
// Check if the pressed key is question mark
if( event.shiftKey && event.charCode === 63 ) {
toggleHelp();
}
}
/**
* Handler for the document level 'keydown' event.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onDocumentKeyDown( event ) {
// If there's a condition specified and it returns false,
// ignore this event
if( typeof config.keyboardCondition === 'function' && config.keyboardCondition(event) === false ) {
return true;
}
2019-01-22 15:43:31 +01:00
// Shorthand
2020-03-06 17:40:11 +01:00
let keyCode = event.keyCode;
2019-01-22 15:43:31 +01:00
2013-12-21 18:12:02 +01:00
// Remember if auto-sliding was paused so we can toggle it
2020-03-06 17:40:11 +01:00
let autoSlideWasPaused = autoSlidePaused;
2013-12-21 18:12:02 +01:00
onUserInput( event );
// Is there a focused element that could be using the keyboard?
2020-03-06 17:40:11 +01:00
let activeElementIsCE = document.activeElement && document.activeElement.contentEditable !== 'inherit';
let activeElementIsInput = document.activeElement && document.activeElement.tagName && /input|textarea/i.test( document.activeElement.tagName );
let activeElementIsNotes = document.activeElement && document.activeElement.className && /speaker-notes/i.test( document.activeElement.className);
// Whitelist specific modified + keycode combinations
2020-03-06 17:40:11 +01:00
let prevSlideShortcut = event.shiftKey && event.keyCode === 32;
let firstSlideShortcut = event.shiftKey && keyCode === 37;
let lastSlideShortcut = event.shiftKey && keyCode === 39;
// Prevent all other events when a modifier is pressed
2020-03-06 17:40:11 +01:00
let unusedModifier = !prevSlideShortcut && !firstSlideShortcut && !lastSlideShortcut &&
( event.shiftKey || event.altKey || event.ctrlKey || event.metaKey );
// Disregard the event if there's a focused element or a
// keyboard modifier key is present
if( activeElementIsCE || activeElementIsInput || activeElementIsNotes || unusedModifier ) return;
// While paused only allow resume keyboard events; 'b', 'v', '.'
2020-03-06 17:40:11 +01:00
let resumeKeyCodes = [66,86,190,191];
let key;
2015-08-14 23:16:59 +02:00
// Custom key bindings for togglePause should be able to resume
if( typeof config.keyboard === 'object' ) {
2015-08-14 23:34:19 +02:00
for( key in config.keyboard ) {
2015-08-14 23:16:59 +02:00
if( config.keyboard[key] === 'togglePause' ) {
2015-08-14 23:25:30 +02:00
resumeKeyCodes.push( parseInt( key, 10 ) );
2015-08-14 23:16:59 +02:00
}
2015-08-14 23:25:30 +02:00
}
2015-08-14 23:16:59 +02:00
}
2015-06-03 11:59:00 +02:00
2019-01-22 15:43:31 +01:00
if( isPaused() && resumeKeyCodes.indexOf( keyCode ) === -1 ) {
return false;
}
// Use linear navigation if we're configured to OR if
// the presentation is one-dimensional
2020-03-06 17:40:11 +01:00
let useLinearMode = config.navigationMode === 'linear' || !hasHorizontalSlides() || !hasVerticalSlides();
2020-03-06 17:40:11 +01:00
let triggered = false;
2013-06-16 17:49:51 +02:00
// 1. User defined key bindings
if( typeof config.keyboard === 'object' ) {
2015-08-14 23:34:19 +02:00
for( key in config.keyboard ) {
2013-06-16 17:49:51 +02:00
// Check if this binding matches the pressed key
2019-01-22 15:43:31 +01:00
if( parseInt( key, 10 ) === keyCode ) {
2013-06-16 17:49:51 +02:00
2020-03-07 11:58:18 +01:00
let value = config.keyboard[ key ];
2013-06-16 17:49:51 +02:00
2013-07-10 15:01:56 +02:00
// Callback function
2013-06-16 17:49:51 +02:00
if( typeof value === 'function' ) {
value.apply( null, [ event ] );
}
// String shortcuts to reveal.js API
else if( typeof value === 'string' && typeof Reveal[ value ] === 'function' ) {
Reveal[ value ].call();
}
triggered = true;
}
}
}
// 2. Registered custom key bindings
if( triggered === false ) {
for( key in registeredKeyBindings ) {
// Check if this binding matches the pressed key
2019-01-22 15:43:31 +01:00
if( parseInt( key, 10 ) === keyCode ) {
2020-03-06 17:40:11 +01:00
let action = registeredKeyBindings[ key ].callback;
// Callback function
if( typeof action === 'function' ) {
action.apply( null, [ event ] );
}
// String shortcuts to reveal.js API
else if( typeof action === 'string' && typeof Reveal[ action ] === 'function' ) {
Reveal[ action ].call();
}
triggered = true;
}
}
}
// 3. System defined key bindings
2013-06-16 17:49:51 +02:00
if( triggered === false ) {
// Assume true and try to prove false
triggered = true;
2019-01-22 15:43:31 +01:00
// P, PAGE UP
if( keyCode === 80 || keyCode === 33 ) {
navigatePrev();
}
// N, PAGE DOWN
else if( keyCode === 78 || keyCode === 34 ) {
navigateNext();
}
// H, LEFT
else if( keyCode === 72 || keyCode === 37 ) {
if( firstSlideShortcut ) {
slide( 0 );
}
2020-03-09 20:57:12 +01:00
else if( !overview.isActive() && useLinearMode ) {
2019-01-22 15:43:31 +01:00
navigatePrev();
}
else {
navigateLeft();
}
}
// L, RIGHT
else if( keyCode === 76 || keyCode === 39 ) {
if( lastSlideShortcut ) {
slide( Number.MAX_VALUE );
}
2020-03-09 20:57:12 +01:00
else if( !overview.isActive() && useLinearMode ) {
2019-01-22 15:43:31 +01:00
navigateNext();
}
else {
navigateRight();
}
}
// K, UP
else if( keyCode === 75 || keyCode === 38 ) {
2020-03-09 20:57:12 +01:00
if( !overview.isActive() && useLinearMode ) {
2019-01-22 15:43:31 +01:00
navigatePrev();
}
else {
navigateUp();
2019-01-22 15:43:31 +01:00
}
}
// J, DOWN
else if( keyCode === 74 || keyCode === 40 ) {
2020-03-09 20:57:12 +01:00
if( !overview.isActive() && useLinearMode ) {
navigateNext();
2019-01-22 15:43:31 +01:00
}
else {
navigateDown();
2019-01-22 15:43:31 +01:00
}
}
// HOME
else if( keyCode === 36 ) {
slide( 0 );
}
// END
else if( keyCode === 35 ) {
slide( Number.MAX_VALUE );
}
// SPACE
else if( keyCode === 32 ) {
2020-03-09 20:57:12 +01:00
if( overview.isActive() ) {
overview.deactivate();
2019-01-22 15:43:31 +01:00
}
if( event.shiftKey ) {
navigatePrev();
}
else {
navigateNext();
}
}
// TWO-SPOT, SEMICOLON, B, V, PERIOD, LOGITECH PRESENTER TOOLS "BLACK SCREEN" BUTTON
else if( keyCode === 58 || keyCode === 59 || keyCode === 66 || keyCode === 86 || keyCode === 190 || keyCode === 191 ) {
togglePause();
}
// F
else if( keyCode === 70 ) {
enterFullscreen();
}
// A
else if( keyCode === 65 ) {
if ( config.autoSlideStoppable ) {
toggleAutoSlide( autoSlideWasPaused );
}
}
else {
triggered = false;
2013-06-16 17:49:51 +02:00
}
}
// If the input resulted in a triggered action we should prevent
// the browsers default behavior
if( triggered ) {
2014-05-04 09:32:10 +02:00
event.preventDefault && event.preventDefault();
}
// ESC or O key
else if( keyCode === 27 || keyCode === 79 ) {
if( dom.overlay ) {
closeOverlay();
}
else {
2020-03-09 20:57:12 +01:00
overview.toggle();
}
2014-05-04 09:32:10 +02:00
event.preventDefault && event.preventDefault();
}
// If auto-sliding is enabled we need to cue up
// another timeout
cueAutoSlide();
}
/**
2013-03-09 01:31:36 +01:00
* Handler for the 'touchstart' event, enables support for
* swipe and pinch gestures.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onTouchStart( event ) {
2015-09-10 11:25:19 +02:00
if( isSwipePrevented( event.target ) ) return true;
touch.startX = event.touches[0].clientX;
touch.startY = event.touches[0].clientY;
touch.startCount = event.touches.length;
}
/**
* Handler for the 'touchmove' event.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onTouchMove( event ) {
2015-09-10 11:25:19 +02:00
if( isSwipePrevented( event.target ) ) return true;
// Each touch should only trigger one action
2013-08-10 20:09:23 +02:00
if( !touch.captured ) {
onUserInput( event );
2020-03-06 17:40:11 +01:00
let currentX = event.touches[0].clientX;
let currentY = event.touches[0].clientY;
// There was only one touch point, look for a swipe
if( event.touches.length === 1 && touch.startCount !== 2 ) {
2020-03-06 17:40:11 +01:00
let deltaX = currentX - touch.startX,
deltaY = currentY - touch.startY;
if( deltaX > touch.threshold && Math.abs( deltaX ) > Math.abs( deltaY ) ) {
2013-08-10 20:09:23 +02:00
touch.captured = true;
2019-06-10 07:13:54 +02:00
if( config.navigationMode === 'linear' ) {
if( config.rtl ) {
navigateNext();
}
else {
navigatePrev();
}
}
else {
navigateLeft();
}
}
else if( deltaX < -touch.threshold && Math.abs( deltaX ) > Math.abs( deltaY ) ) {
2013-08-10 20:09:23 +02:00
touch.captured = true;
2019-06-10 07:13:54 +02:00
if( config.navigationMode === 'linear' ) {
if( config.rtl ) {
navigatePrev();
}
else {
navigateNext();
}
}
else {
navigateRight();
}
}
else if( deltaY > touch.threshold ) {
2013-08-10 20:09:23 +02:00
touch.captured = true;
2019-06-10 07:13:54 +02:00
if( config.navigationMode === 'linear' ) {
navigatePrev();
}
else {
navigateUp();
}
}
else if( deltaY < -touch.threshold ) {
2013-08-10 20:09:23 +02:00
touch.captured = true;
2019-06-10 07:13:54 +02:00
if( config.navigationMode === 'linear' ) {
navigateNext();
}
else {
navigateDown();
}
}
2013-08-10 20:30:24 +02:00
// If we're embedded, only block touch events if they have
// triggered an action
if( config.embedded ) {
2013-08-10 20:30:24 +02:00
if( touch.captured || isVerticalSlide( currentSlide ) ) {
event.preventDefault();
}
}
// Not embedded? Block them all to avoid needless tossing
// around of the viewport in iOS
else {
event.preventDefault();
}
}
}
// There's a bug with swiping on some Android devices unless
// the default action is always prevented
2020-03-09 18:51:07 +01:00
else if( isAndroid ) {
event.preventDefault();
}
}
/**
* Handler for the 'touchend' event.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onTouchEnd( event ) {
2013-08-10 20:09:23 +02:00
touch.captured = false;
}
/**
* Convert pointer down to touch start.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onPointerDown( event ) {
2013-12-02 23:23:51 +01:00
if( event.pointerType === event.MSPOINTER_TYPE_TOUCH || event.pointerType === "touch" ) {
event.touches = [{ clientX: event.clientX, clientY: event.clientY }];
2013-03-05 15:48:42 +01:00
onTouchStart( event );
}
}
/**
* Convert pointer move to touch move.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onPointerMove( event ) {
2013-12-02 23:23:51 +01:00
if( event.pointerType === event.MSPOINTER_TYPE_TOUCH || event.pointerType === "touch" ) {
event.touches = [{ clientX: event.clientX, clientY: event.clientY }];
2013-03-05 15:48:42 +01:00
onTouchMove( event );
}
}
/**
* Convert pointer up to touch end.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onPointerUp( event ) {
2013-12-02 23:23:51 +01:00
if( event.pointerType === event.MSPOINTER_TYPE_TOUCH || event.pointerType === "touch" ) {
event.touches = [{ clientX: event.clientX, clientY: event.clientY }];
2013-03-05 15:48:42 +01:00
onTouchEnd( event );
}
}
/**
* Handles mouse wheel scrolling, throttled to avoid skipping
* multiple slides.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onDocumentMouseScroll( event ) {
2013-06-17 01:55:50 +02:00
if( Date.now() - lastMouseWheelStep > 600 ) {
lastMouseWheelStep = Date.now();
2020-03-06 17:40:11 +01:00
let delta = event.detail || -event.wheelDelta;
if( delta > 0 ) {
navigateNext();
}
else if( delta < 0 ) {
navigatePrev();
}
2013-06-17 01:55:50 +02:00
}
}
/**
* Clicking on the progress bar results in a navigation to the
* closest approximate horizontal slide using this equation:
*
* ( clickX / presentationWidth ) * numberOfSlides
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onProgressClicked( event ) {
onUserInput( event );
event.preventDefault();
2020-03-06 17:40:11 +01:00
let slidesTotal = getHorizontalSlides().length;
let slideIndex = Math.floor( ( event.clientX / dom.wrapper.offsetWidth ) * slidesTotal );
if( config.rtl ) {
slideIndex = slidesTotal - slideIndex;
}
slide( slideIndex );
}
/**
* Event handler for navigation control buttons.
*/
function onNavigateLeftClicked( event ) { event.preventDefault(); onUserInput(); config.navigationMode === 'linear' ? navigatePrev() : navigateLeft(); }
function onNavigateRightClicked( event ) { event.preventDefault(); onUserInput(); config.navigationMode === 'linear' ? navigateNext() : navigateRight(); }
function onNavigateUpClicked( event ) { event.preventDefault(); onUserInput(); navigateUp(); }
function onNavigateDownClicked( event ) { event.preventDefault(); onUserInput(); navigateDown(); }
function onNavigatePrevClicked( event ) { event.preventDefault(); onUserInput(); navigatePrev(); }
function onNavigateNextClicked( event ) { event.preventDefault(); onUserInput(); navigateNext(); }
/**
* Handler for the window level 'hashchange' event.
2016-06-30 05:10:55 +02:00
*
* @param {object} [event]
*/
function onWindowHashChange( event ) {
readURL();
}
/**
* Handler for the window level 'resize' event.
2016-06-30 05:10:55 +02:00
*
* @param {object} [event]
*/
function onWindowResize( event ) {
layout();
}
/**
* Handle for the window level 'visibilitychange' event.
2016-06-30 05:10:55 +02:00
*
* @param {object} [event]
*/
function onPageVisibilityChange( event ) {
// If, after clicking a link or similar and we're coming back,
// focus the document.body to ensure we can use keyboard shortcuts
2020-03-02 14:52:50 +01:00
if( document.hidden === false && document.activeElement !== document.body ) {
// Not all elements support .blur() - SVGs among them.
2015-03-02 12:11:05 +01:00
if( typeof document.activeElement.blur === 'function' ) {
document.activeElement.blur();
}
document.body.focus();
}
}
/**
* Handles clicks on links that are set to preview in the
* iframe overlay.
2016-06-30 05:10:55 +02:00
*
* @param {object} event
*/
function onPreviewLinkClicked( event ) {
2014-09-04 18:00:21 +02:00
if( event.currentTarget && event.currentTarget.hasAttribute( 'href' ) ) {
2020-03-06 17:40:11 +01:00
let url = event.currentTarget.getAttribute( 'href' );
2014-09-04 18:00:21 +02:00
if( url ) {
showPreview( url );
event.preventDefault();
}
}
}
/**
* Handles click on the auto-sliding controls element.
2016-06-30 05:10:55 +02:00
*
* @param {object} [event]
*/
function onAutoSlidePlayerClick( event ) {
// Replay
2020-03-09 20:57:12 +01:00
if( isLastSlide() && config.loop === false ) {
slide( 0, 0 );
resumeAutoSlide();
}
// Resume
else if( autoSlidePaused ) {
resumeAutoSlide();
}
// Pause
else {
pauseAutoSlide();
}
}
// --------------------------------------------------------------------//
// ------------------------------- API --------------------------------//
// --------------------------------------------------------------------//
return extend( Reveal, {
2020-03-07 18:48:39 +01:00
VERSION,
2016-01-08 10:26:41 +01:00
initialize,
2020-03-06 17:50:15 +01:00
configure,
2018-05-31 10:35:07 +02:00
2020-03-06 17:50:15 +01:00
sync,
syncSlide,
syncFragments,
// Navigation methods
2020-03-06 17:50:15 +01:00
slide,
left: navigateLeft,
right: navigateRight,
up: navigateUp,
down: navigateDown,
prev: navigatePrev,
next: navigateNext,
// Deprecated aliases
navigateTo: slide,
2011-06-07 21:10:59 +02:00
navigateLeft: navigateLeft,
navigateRight: navigateRight,
navigateUp: navigateUp,
navigateDown: navigateDown,
2012-06-12 00:28:17 +02:00
navigatePrev: navigatePrev,
navigateNext: navigateNext,
2020-03-06 17:50:15 +01:00
// Fragment methods
2020-03-09 21:04:31 +01:00
navigateFragment: () => fragments.goto.bind( fragments ),
prevFragment: () => fragments.prev.bind( fragments ),
nextFragment: () => fragments.next.bind( fragments ),
2020-03-06 17:50:15 +01:00
// Forces an update in slide layout
2020-03-06 17:50:15 +01:00
layout,
// Randomizes the order of slides
2020-03-06 17:50:15 +01:00
shuffle,
2013-03-23 16:42:21 +01:00
// Returns an object with the available routes as booleans (left/right/top/bottom)
2020-03-06 17:50:15 +01:00
availableRoutes,
2013-03-23 16:42:21 +01:00
// Returns an object with the available fragments as booleans (prev/next)
2020-03-09 21:04:31 +01:00
availableFragments: fragments.availableRoutes.bind( fragments ),
2017-02-09 11:37:47 +01:00
// Toggles a help overlay with keyboard shortcuts
2020-03-06 17:50:15 +01:00
toggleHelp,
2017-02-09 11:37:47 +01:00
// Toggles the overview mode on/off
2020-03-09 21:04:31 +01:00
toggleOverview: overview.toggle.bind( overview ),
2013-01-18 17:01:09 +01:00
// Toggles the "black screen" mode on/off
2020-03-06 17:50:15 +01:00
togglePause,
2013-01-18 17:01:09 +01:00
// Toggles the auto slide mode on/off
2020-03-06 17:50:15 +01:00
toggleAutoSlide,
2020-03-09 20:57:12 +01:00
// Slide navigation checks
isFirstSlide,
isLastSlide,
isLastVerticalSlide,
// State checks
2020-03-09 21:04:31 +01:00
isOverview: () => overview.isActive.bind( overview ),
2020-03-06 17:50:15 +01:00
isPaused,
isAutoSliding,
isSpeakerNotes,
// Slide preloading
2020-03-09 21:04:31 +01:00
loadSlide: () => slideContent.load.bind( slideContent ),
unloadSlide: () => slideContent.unload.bind( slideContent ),
// Adds or removes all internal event listeners (such as keyboard)
2020-03-06 17:50:15 +01:00
addEventListeners,
removeEventListeners,
dispatchEvent,
// Facility for persisting and restoring the presentation state
2020-03-06 17:50:15 +01:00
getState,
setState,
// Presentation progress
2020-03-06 17:50:15 +01:00
getSlidePastCount,
2014-03-12 22:26:31 +01:00
// Presentation progress on range of 0-1
2020-03-06 17:50:15 +01:00
getProgress,
2014-03-12 22:26:31 +01:00
2012-08-21 04:13:00 +02:00
// Returns the indices of the current, or specified, slide
2020-03-06 17:50:15 +01:00
getIndices,
// Returns an Array of all slides
2020-03-06 17:50:15 +01:00
getSlides,
2018-02-20 16:08:29 +01:00
// Returns an Array of objects representing the attributes on
// the slides
2020-03-06 17:50:15 +01:00
getSlidesAttributes,
// Returns the total number of slides
2020-03-06 17:50:15 +01:00
getTotalSlides,
2014-04-01 09:12:41 +02:00
2014-04-27 14:46:49 +02:00
// Returns the slide element at the specified index
2020-03-06 17:50:15 +01:00
getSlide,
2014-04-27 14:46:49 +02:00
// Returns the slide background element at the specified index
2020-03-06 17:50:15 +01:00
getSlideBackground,
2015-09-10 08:28:52 +02:00
// Returns the speaker notes string for a slide, or null
2020-03-06 17:50:15 +01:00
getSlideNotes,
2015-09-10 08:28:52 +02:00
// Returns an array with all horizontal/vertical slides in the deck
2020-03-06 17:50:15 +01:00
getHorizontalSlides,
getVerticalSlides,
// Checks if the presentation contains two or more
// horizontal/vertical slides
2020-03-06 17:50:15 +01:00
hasHorizontalSlides,
hasVerticalSlides,
// Adds/removes a custom key binding
addKeyBinding,
removeKeyBinding,
2020-03-09 18:51:07 +01:00
// Programmatically triggers a keyboard event
triggerKey: keyCode => onDocumentKeyDown( { keyCode } ),
// Registers a new shortcut to include in the help overlay
registerKeyboardShortcut: ( key, value ) => keyboardShortcuts[key] = value,
// Forward event binding to the reveal DOM element
addEventListener: ( type, listener, useCapture ) => {
Reveal.getRevealElement().addEventListener( type, listener, useCapture );
},
removeEventListener: ( type, listener, useCapture ) => {
Reveal.getRevealElement().removeEventListener( type, listener, useCapture );
},
2020-03-06 17:50:15 +01:00
// API for registering and retrieving plugins
2020-03-09 21:04:31 +01:00
registerPlugin: () => plugins.registerPlugin.bind( plugins ),
hasPlugin: () => plugins.hasPlugin.bind( plugins ),
getPlugin: () => plugins.getPlugin.bind( plugins ),
// Returns a hash with all registered plugins
2020-03-09 21:04:31 +01:00
getPlugins: () => plugins.getRegisteredPlugins.bind( plugins ),
2020-03-06 17:50:15 +01:00
getComputedSlideSize,
// Returns the previous slide element, may be null
getPreviousSlide: () => previousSlide,
// Returns the current slide element
getCurrentSlide: () => currentSlide,
// Returns the current scale of the presentation content
getScale: () => scale,
// Returns the current configuration object
getConfig: () => config,
// Helper method, retrieves query string as a key/value hash
2020-03-06 17:40:11 +01:00
getQueryHash: () => {
let query = {};
2020-03-06 17:40:11 +01:00
location.search.replace( /[A-Z0-9]+?=([\w\.%-]*)/gi, a => {
query[ a.split( '=' ).shift() ] = a.split( '=' ).pop();
} );
// Basic deserialization
2020-03-06 17:40:11 +01:00
for( let i in query ) {
let value = query[ i ];
2013-11-27 19:16:03 +01:00
2014-03-12 08:51:51 +01:00
query[ i ] = deserialize( unescape( value ) );
}
2020-03-07 18:48:39 +01:00
// Do not accept new dependencies via query config to avoid
// the potential of malicious script injection
if( typeof query['dependencies'] !== 'undefined' ) delete query['dependencies'];
return query;
},
2018-11-16 10:39:43 +01:00
// Returns the top-level DOM element
getRevealElement: () => dom.wrapper || document.querySelector( '.reveal' ),
getSlidesElement: () => dom.slides,
2020-03-09 20:57:12 +01:00
getBackgroundsElement: () => dom.background,
// Checks if reveal.js has been loaded and is ready for use
isReady: () => ready,
2020-03-09 20:57:12 +01:00
// The following API methods are primarily intended for use
// by reveal.js controllers
2020-03-09 18:51:07 +01:00
// Methods for announcing content to screen readers
announceStatus,
getStatusText,
slideContent,
updateControls,
updateProgress,
2020-03-09 20:57:12 +01:00
updateSlidesVisibility,
writeURL,
transformSlides,
cueAutoSlide,
cancelAutoSlide
} );
2014-04-09 02:08:21 +02:00
};