123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904 |
- import SlideContent from './controllers/slidecontent.js'
- import SlideNumber from './controllers/slidenumber.js'
- import JumpToSlide from './controllers/jumptoslide.js'
- import Backgrounds from './controllers/backgrounds.js'
- import AutoAnimate from './controllers/autoanimate.js'
- import ScrollView from './controllers/scrollview.js'
- import PrintView from './controllers/printview.js'
- import Fragments from './controllers/fragments.js'
- import Overview from './controllers/overview.js'
- import Keyboard from './controllers/keyboard.js'
- import Location from './controllers/location.js'
- import Controls from './controllers/controls.js'
- import Progress from './controllers/progress.js'
- import Pointer from './controllers/pointer.js'
- import Plugins from './controllers/plugins.js'
- import Overlay from './controllers/overlay.js'
- import Touch from './controllers/touch.js'
- import Focus from './controllers/focus.js'
- import Notes from './controllers/notes.js'
- import Playback from './components/playback.js'
- import defaultConfig from './config.js'
- import * as Util from './utils/util.js'
- import * as Device from './utils/device.js'
- import {
- SLIDES_SELECTOR,
- HORIZONTAL_SLIDES_SELECTOR,
- VERTICAL_SLIDES_SELECTOR,
- POST_MESSAGE_METHOD_BLACKLIST
- } from './utils/constants.js'
- // The reveal.js version
- export const VERSION = '5.2.0';
- /**
- * reveal.js
- * https://revealjs.com
- * MIT licensed
- *
- * Copyright (C) 2011-2022 Hakim El Hattab, https://hakim.se
- */
- export default function( revealElement, options ) {
- // Support initialization with no args, one arg
- // [options] or two args [revealElement, options]
- if( arguments.length < 2 ) {
- options = arguments[0];
- revealElement = document.querySelector( '.reveal' );
- }
- const Reveal = {};
- // Configuration defaults, can be overridden at initialization time
- let config = {},
- // Flags if initialize() has been invoked for this reveal instance
- initialized = false,
- // Flags if reveal.js is loaded (has dispatched the 'ready' event)
- ready = false,
- // The horizontal and vertical index of the currently active slide
- indexh,
- indexv,
- // The previous and current slide HTML elements
- previousSlide,
- currentSlide,
- // Remember which directions that the user has navigated towards
- navigationHistory = {
- hasNavigatedHorizontally: false,
- hasNavigatedVertically: false
- },
- // Slides may have 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: '' },
- // Cached references to DOM elements
- dom = {},
- // Flags if the interaction event listeners are bound
- eventsAreBound = false,
- // The current slide transition state; idle or running
- transition = 'idle',
- // The current auto-slide duration
- autoSlide = 0,
- // Auto slide properties
- autoSlidePlayer,
- autoSlideTimeout = 0,
- autoSlideStartTime = -1,
- autoSlidePaused = false,
- // Controllers for different aspects of our presentation. They're
- // all given direct references to this Reveal instance since there
- // may be multiple presentations running in parallel.
- slideContent = new SlideContent( Reveal ),
- slideNumber = new SlideNumber( Reveal ),
- jumpToSlide = new JumpToSlide( Reveal ),
- autoAnimate = new AutoAnimate( Reveal ),
- backgrounds = new Backgrounds( Reveal ),
- scrollView = new ScrollView( Reveal ),
- printView = new PrintView( Reveal ),
- fragments = new Fragments( Reveal ),
- overview = new Overview( Reveal ),
- keyboard = new Keyboard( Reveal ),
- location = new Location( Reveal ),
- controls = new Controls( Reveal ),
- progress = new Progress( Reveal ),
- pointer = new Pointer( Reveal ),
- plugins = new Plugins( Reveal ),
- overlay = new Overlay( Reveal ),
- focus = new Focus( Reveal ),
- touch = new Touch( Reveal ),
- notes = new Notes( Reveal );
- /**
- * Starts up the presentation.
- */
- function initialize( initOptions ) {
- if( !revealElement ) throw 'Unable to find presentation root (<div class="reveal">).';
- if( initialized ) throw 'Reveal.js has already been initialized.';
- initialized = true;
- // Cache references to key DOM elements
- dom.wrapper = revealElement;
- dom.slides = revealElement.querySelector( '.slides' );
- if( !dom.slides ) throw 'Unable to find slides container (<div class="slides">).';
- // Compose our config object in order of increasing precedence:
- // 1. Default reveal.js options
- // 2. Options provided via Reveal.configure() prior to
- // initialization
- // 3. Options passed to the Reveal constructor
- // 4. Options passed to Reveal.initialize
- // 5. Query params
- config = { ...defaultConfig, ...config, ...options, ...initOptions, ...Util.getQueryHash() };
- // Legacy support for the ?print-pdf query
- if( /print-pdf/gi.test( window.location.search ) ) {
- config.view = 'print';
- }
- setViewport();
- // Force a layout when the whole page, incl fonts, has loaded
- window.addEventListener( 'load', layout, false );
- // Register plugins and load dependencies, then move on to #start()
- plugins.load( config.plugins, config.dependencies ).then( start );
- return new Promise( resolve => Reveal.on( 'ready', resolve ) );
- }
- /**
- * Encase the presentation in a reveal.js viewport. The
- * extent of the viewport differs based on configuration.
- */
- function setViewport() {
- // Embedded decks use the reveal element as their viewport
- if( config.embedded === true ) {
- dom.viewport = Util.closest( revealElement, '.reveal-viewport' ) || revealElement;
- }
- // Full-page decks use the body as their viewport
- else {
- dom.viewport = document.body;
- document.documentElement.classList.add( 'reveal-full-page' );
- }
- dom.viewport.classList.add( 'reveal-viewport' );
- }
- /**
- * Starts up reveal.js by binding input events and navigating
- * to the current URL deeplink if there is one.
- */
- function start() {
- // Don't proceed if this instance has been destroyed
- if( initialized === false ) return;
- ready = true;
- // Remove slides hidden with data-visibility
- removeHiddenSlides();
- // Make sure we've got all the DOM elements we need
- setupDOM();
- // Listen to messages posted to this window
- setupPostMessage();
- // Prevent the slides from being scrolled out of view
- setupScrollPrevention();
- // Adds bindings for fullscreen mode
- setupFullscreen();
- // Resets all vertical slides so that only the first is visible
- resetVerticalSlides();
- // Updates the presentation to match the current configuration values
- configure();
- // Create slide backgrounds
- backgrounds.update( true );
- // Activate the print/scroll view if configured
- activateInitialView();
- // Read the initial hash
- location.readURL();
- // Notify listeners that the presentation is ready but use a 1ms
- // timeout to ensure it's not fired synchronously after #initialize()
- setTimeout( () => {
- // Enable transitions now that we're loaded
- dom.slides.classList.remove( 'no-transition' );
- dom.wrapper.classList.add( 'ready' );
- dispatchEvent({
- type: 'ready',
- data: {
- indexh,
- indexv,
- currentSlide
- }
- });
- }, 1 );
- }
- /**
- * Activates the correct reveal.js view based on our config.
- * This is only invoked once during initialization.
- */
- function activateInitialView() {
- const activatePrintView = config.view === 'print';
- const activateScrollView = config.view === 'scroll' || config.view === 'reader';
- if( activatePrintView || activateScrollView ) {
- if( activatePrintView ) {
- removeEventListeners();
- }
- else {
- touch.unbind();
- }
- // Avoid content flickering during layout
- dom.viewport.classList.add( 'loading-scroll-mode' );
- if( activatePrintView ) {
- // The document needs to have loaded for the PDF layout
- // measurements to be accurate
- if( document.readyState === 'complete' ) {
- printView.activate();
- }
- else {
- window.addEventListener( 'load', () => printView.activate() );
- }
- }
- else {
- scrollView.activate();
- }
- }
- }
- /**
- * Removes all slides with data-visibility="hidden". This
- * is done right before the rest of the presentation is
- * initialized.
- *
- * If you want to show all hidden slides, initialize
- * reveal.js with showHiddenSlides set to true.
- */
- function removeHiddenSlides() {
- if( !config.showHiddenSlides ) {
- Util.queryAll( dom.wrapper, 'section[data-visibility="hidden"]' ).forEach( slide => {
- const parent = slide.parentNode;
- // If this slide is part of a stack and that stack will be
- // empty after removing the hidden slide, remove the entire
- // stack
- if( parent.childElementCount === 1 && /section/i.test( parent.nodeName ) ) {
- parent.remove();
- }
- else {
- slide.remove();
- }
- } );
- }
- }
- /**
- * 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' );
- if( Device.isMobile ) {
- dom.wrapper.classList.add( 'no-hover' );
- }
- else {
- dom.wrapper.classList.remove( 'no-hover' );
- }
- backgrounds.render();
- slideNumber.render();
- jumpToSlide.render();
- controls.render();
- progress.render();
- notes.render();
- // Overlay graphic which is displayed during the paused mode
- dom.pauseOverlay = Util.createSingletonNode( dom.wrapper, 'div', 'pause-overlay', config.controls ? '<button class="resume-button">Resume presentation</button>' : null );
- dom.statusElement = createStatusElement();
- dom.wrapper.setAttribute( 'role', 'application' );
- }
- /**
- * 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.
- *
- * @return {HTMLElement}
- */
- 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 );
- }
- return statusElement;
- }
- /**
- * Announces the given text to screen readers.
- */
- function announceStatus( value ) {
- dom.statusElement.textContent = value;
- }
- /**
- * 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 ) {
- let text = '';
- // Text node
- if( node.nodeType === 3 ) {
- text += node.textContent;
- }
- // Element node
- else if( node.nodeType === 1 ) {
- let isAriaHidden = node.getAttribute( 'aria-hidden' );
- let isDisplayHidden = window.getComputedStyle( node )['display'] === 'none';
- if( isAriaHidden !== 'true' && !isDisplayHidden ) {
- Array.from( node.childNodes ).forEach( child => {
- text += getStatusText( child );
- } );
- }
- }
- text = text.trim();
- return text === '' ? '' : text + ' ';
- }
- /**
- * 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
- * CSS (we already do) so we have to resort to repeatedly
- * checking if the slides have been offset :(
- */
- function setupScrollPrevention() {
- setInterval( () => {
- if( !scrollView.isActive() && dom.wrapper.scrollTop !== 0 || dom.wrapper.scrollLeft !== 0 ) {
- dom.wrapper.scrollTop = 0;
- dom.wrapper.scrollLeft = 0;
- }
- }, 1000 );
- }
- /**
- * After entering fullscreen we need to force a layout to
- * get our presentations to scale correctly. This behavior
- * is inconsistent across browsers but a force layout seems
- * to normalize it.
- */
- function setupFullscreen() {
- document.addEventListener( 'fullscreenchange', onFullscreenChange );
- document.addEventListener( 'webkitfullscreenchange', onFullscreenChange );
- }
- /**
- * 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 ) {
- window.addEventListener( 'message', onPostMessage, false );
- }
- }
- /**
- * Applies the configuration settings from the config
- * object. May be called multiple times.
- *
- * @param {object} options
- */
- function configure( options ) {
- const oldConfig = { ...config }
- // New config options may be passed when this method
- // is invoked through the API after initialization
- if( typeof options === 'object' ) Util.extend( config, options );
- // Abort if reveal.js hasn't finished loading, config
- // changes will be applied automatically once ready
- if( Reveal.isReady() === false ) return;
- const numberOfSlides = dom.wrapper.querySelectorAll( SLIDES_SELECTOR ).length;
- // The transition is added as a class on the .reveal element
- dom.wrapper.classList.remove( oldConfig.transition );
- dom.wrapper.classList.add( config.transition );
- dom.wrapper.setAttribute( 'data-transition-speed', config.transitionSpeed );
- dom.wrapper.setAttribute( 'data-background-transition', config.backgroundTransition );
- // Expose our configured slide dimensions as custom props
- dom.viewport.style.setProperty( '--slide-width', typeof config.width === 'string' ? config.width : config.width + 'px' );
- dom.viewport.style.setProperty( '--slide-height', typeof config.height === 'string' ? config.height : config.height + 'px' );
- if( config.shuffle ) {
- shuffle();
- }
- Util.toggleClass( dom.wrapper, 'embedded', config.embedded );
- Util.toggleClass( dom.wrapper, 'rtl', config.rtl );
- Util.toggleClass( dom.wrapper, 'center', config.center );
- // Exit the paused mode if it was configured off
- if( config.pause === false ) {
- resume();
- }
- // Reset all changes made by auto-animations
- autoAnimate.reset();
- // Remove existing auto-slide controls
- if( autoSlidePlayer ) {
- autoSlidePlayer.destroy();
- autoSlidePlayer = null;
- }
- // Generate auto-slide controls if needed
- if( numberOfSlides > 1 && config.autoSlide && config.autoSlideStoppable ) {
- autoSlidePlayer = new Playback( dom.wrapper, () => {
- return Math.min( Math.max( ( Date.now() - autoSlideStartTime ) / autoSlide, 0 ), 1 );
- } );
- autoSlidePlayer.on( 'click', onAutoSlidePlayerClick );
- autoSlidePaused = false;
- }
- // 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' );
- }
- notes.configure( config, oldConfig );
- focus.configure( config, oldConfig );
- pointer.configure( config, oldConfig );
- controls.configure( config, oldConfig );
- progress.configure( config, oldConfig );
- keyboard.configure( config, oldConfig );
- fragments.configure( config, oldConfig );
- slideNumber.configure( config, oldConfig );
- sync();
- }
- /**
- * Binds all event listeners.
- */
- function addEventListeners() {
- eventsAreBound = true;
- window.addEventListener( 'resize', onWindowResize, false );
- if( config.touch ) touch.bind();
- if( config.keyboard ) keyboard.bind();
- if( config.progress ) progress.bind();
- if( config.respondToHashChanges ) location.bind();
- controls.bind();
- focus.bind();
- dom.slides.addEventListener( 'click', onSlidesClicked, false );
- dom.slides.addEventListener( 'transitionend', onTransitionEnd, false );
- dom.pauseOverlay.addEventListener( 'click', resume, false );
- if( config.focusBodyOnPageVisibilityChange ) {
- document.addEventListener( 'visibilitychange', onPageVisibilityChange, false );
- }
- }
- /**
- * Unbinds all event listeners.
- */
- function removeEventListeners() {
- eventsAreBound = false;
- touch.unbind();
- focus.unbind();
- keyboard.unbind();
- controls.unbind();
- progress.unbind();
- location.unbind();
- window.removeEventListener( 'resize', onWindowResize, false );
- dom.slides.removeEventListener( 'click', onSlidesClicked, false );
- dom.slides.removeEventListener( 'transitionend', onTransitionEnd, false );
- dom.pauseOverlay.removeEventListener( 'click', resume, false );
- }
- /**
- * Uninitializes reveal.js by undoing changes made to the
- * DOM and removing all event listeners.
- */
- function destroy() {
- initialized = false;
- // There's nothing to destroy if this instance hasn't finished
- // initializing
- if( ready === false ) return;
- removeEventListeners();
- cancelAutoSlide();
- // Destroy controllers
- notes.destroy();
- focus.destroy();
- overlay.destroy();
- plugins.destroy();
- pointer.destroy();
- controls.destroy();
- progress.destroy();
- backgrounds.destroy();
- slideNumber.destroy();
- jumpToSlide.destroy();
- // Remove event listeners
- document.removeEventListener( 'fullscreenchange', onFullscreenChange );
- document.removeEventListener( 'webkitfullscreenchange', onFullscreenChange );
- document.removeEventListener( 'visibilitychange', onPageVisibilityChange, false );
- window.removeEventListener( 'message', onPostMessage, false );
- window.removeEventListener( 'load', layout, false );
- // Undo DOM changes
- if( dom.pauseOverlay ) dom.pauseOverlay.remove();
- if( dom.statusElement ) dom.statusElement.remove();
- document.documentElement.classList.remove( 'reveal-full-page' );
- dom.wrapper.classList.remove( 'ready', 'center', 'has-horizontal-slides', 'has-vertical-slides' );
- dom.wrapper.removeAttribute( 'data-transition-speed' );
- dom.wrapper.removeAttribute( 'data-background-transition' );
- dom.viewport.classList.remove( 'reveal-viewport' );
- dom.viewport.style.removeProperty( '--slide-width' );
- dom.viewport.style.removeProperty( '--slide-height' );
- dom.slides.style.removeProperty( 'width' );
- dom.slides.style.removeProperty( 'height' );
- dom.slides.style.removeProperty( 'zoom' );
- dom.slides.style.removeProperty( 'left' );
- dom.slides.style.removeProperty( 'top' );
- dom.slides.style.removeProperty( 'bottom' );
- dom.slides.style.removeProperty( 'right' );
- dom.slides.style.removeProperty( 'transform' );
- Array.from( dom.wrapper.querySelectorAll( SLIDES_SELECTOR ) ).forEach( slide => {
- slide.style.removeProperty( 'display' );
- slide.style.removeProperty( 'top' );
- slide.removeAttribute( 'hidden' );
- slide.removeAttribute( 'aria-hidden' );
- } );
- }
- /**
- * Adds a listener to one of our custom reveal.js events,
- * like slidechanged.
- */
- function on( type, listener, useCapture ) {
- revealElement.addEventListener( type, listener, useCapture );
- }
- /**
- * Unsubscribes from a reveal.js event.
- */
- function off( type, listener, useCapture ) {
- revealElement.removeEventListener( type, listener, useCapture );
- }
- /**
- * Applies CSS transforms to the slides container. The container
- * is transformed from two separate sources: layout and the overview
- * mode.
- *
- * @param {object} transforms
- */
- function transformSlides( transforms ) {
- // Pick up new transforms from arguments
- 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 ) {
- Util.transformElement( dom.slides, slidesTransform.layout + ' ' + slidesTransform.overview );
- }
- else {
- Util.transformElement( dom.slides, slidesTransform.overview );
- }
- }
- /**
- * Dispatches an event of the specified type from the
- * reveal DOM element.
- */
- function dispatchEvent({ target=dom.wrapper, type, data, bubbles=true }) {
- let event = document.createEvent( 'HTMLEvents', 1, 2 );
- event.initEvent( type, bubbles, true );
- Util.extend( event, data );
- target.dispatchEvent( event );
- if( target === dom.wrapper ) {
- // If we're in an iframe, post each reveal.js event to the
- // parent window. Used by the notes plugin
- dispatchPostMessage( type );
- }
- return event;
- }
- /**
- * Dispatches a slidechanged event.
- *
- * @param {string} origin Used to identify multiplex clients
- */
- function dispatchSlideChanged( origin ) {
- dispatchEvent({
- type: 'slidechanged',
- data: {
- indexh,
- indexv,
- previousSlide,
- currentSlide,
- origin
- }
- });
- }
- /**
- * Dispatched a postMessage of the given type from our window.
- */
- function dispatchPostMessage( type, data ) {
- if( config.postMessageEvents && window.parent !== window.self ) {
- let message = {
- namespace: 'reveal',
- eventName: type,
- state: getState()
- };
- Util.extend( message, data );
- window.parent.postMessage( JSON.stringify( message ), '*' );
- }
- }
- /**
- * Applies JavaScript-controlled layout rules to the
- * presentation.
- */
- function layout() {
- if( dom.wrapper && !printView.isActive() ) {
- const viewportWidth = dom.viewport.offsetWidth;
- const viewportHeight = dom.viewport.offsetHeight;
- 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/
- if( Device.isMobile && !config.embedded ) {
- document.documentElement.style.setProperty( '--vh', ( window.innerHeight * 0.01 ) + 'px' );
- }
- const size = scrollView.isActive() ?
- getComputedSlideSize( viewportWidth, viewportHeight ) :
- getComputedSlideSize();
- const oldScale = scale;
- // 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 or we're
- // in the scroll view
- if( scale === 1 || scrollView.isActive() ) {
- dom.slides.style.zoom = '';
- dom.slides.style.left = '';
- dom.slides.style.top = '';
- dom.slides.style.bottom = '';
- dom.slides.style.right = '';
- transformSlides( { layout: '' } );
- }
- 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
- const slides = Array.from( dom.wrapper.querySelectorAll( SLIDES_SELECTOR ) );
- for( let i = 0, len = slides.length; i < len; i++ ) {
- const slide = slides[ i ];
- // Don't bother updating invisible slides
- if( slide.style.display === 'none' ) {
- continue;
- }
- 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 = '';
- }
- }
- if( oldScale !== scale ) {
- dispatchEvent({
- type: 'resize',
- data: {
- oldScale,
- scale,
- size
- }
- });
- }
- }
- checkResponsiveScrollView();
- dom.viewport.style.setProperty( '--slide-scale', scale );
- dom.viewport.style.setProperty( '--viewport-width', viewportWidth + 'px' );
- dom.viewport.style.setProperty( '--viewport-height', viewportHeight + 'px' );
- scrollView.layout();
- progress.update();
- backgrounds.updateParallax();
- if( overview.isActive() ) {
- overview.update();
- }
- }
- }
- /**
- * Applies layout logic to the contents of all slides in
- * the presentation.
- *
- * @param {string|number} width
- * @param {string|number} height
- */
- function layoutSlideContents( width, height ) {
- // Handle sizing of elements with the 'r-stretch' class
- Util.queryAll( dom.slides, 'section > .stretch, section > .r-stretch' ).forEach( element => {
- // Determine how much vertical space we can use
- let remainingHeight = Util.getRemainingHeight( element, height );
- // Consider the aspect ratio of media elements
- if( /(img|video)/gi.test( element.nodeName ) ) {
- const nw = element.naturalWidth || element.videoWidth,
- nh = element.naturalHeight || element.videoHeight;
- const es = Math.min( width / nw, remainingHeight / nh );
- element.style.width = ( nw * es ) + 'px';
- element.style.height = ( nh * es ) + 'px';
- }
- else {
- element.style.width = width + 'px';
- element.style.height = remainingHeight + 'px';
- }
- } );
- }
- /**
- * Responsively activates the scroll mode when we reach the configured
- * activation width.
- */
- function checkResponsiveScrollView() {
- // Only proceed if...
- // 1. The DOM is ready
- // 2. Layouts aren't disabled via config
- // 3. We're not currently printing
- // 4. There is a scrollActivationWidth set
- // 5. The deck isn't configured to always use the scroll view
- if(
- dom.wrapper &&
- !config.disableLayout &&
- !printView.isActive() &&
- typeof config.scrollActivationWidth === 'number' &&
- config.view !== 'scroll'
- ) {
- const size = getComputedSlideSize();
- if( size.presentationWidth > 0 && size.presentationWidth <= config.scrollActivationWidth ) {
- if( !scrollView.isActive() ) {
- backgrounds.create();
- scrollView.activate()
- };
- }
- else {
- if( scrollView.isActive() ) scrollView.deactivate();
- }
- }
- }
- /**
- * Calculates the computed pixel size of our slides. These
- * values are based on the width and height configuration
- * options.
- *
- * @param {number} [presentationWidth=dom.wrapper.offsetWidth]
- * @param {number} [presentationHeight=dom.wrapper.offsetHeight]
- */
- function getComputedSlideSize( presentationWidth, presentationHeight ) {
- let width = config.width;
- let height = config.height;
- if( config.disableLayout ) {
- width = dom.slides.offsetWidth;
- height = dom.slides.offsetHeight;
- }
- const size = {
- // Slide size
- width: width,
- height: height,
- // Presentation size
- presentationWidth: presentationWidth || dom.wrapper.offsetWidth,
- presentationHeight: presentationHeight || dom.wrapper.offsetHeight
- };
- // Reduce available space by margin
- 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
- * @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' ) ) {
- // Prefer manually defined start-indexv
- const attributeName = stack.hasAttribute( 'data-start-indexv' ) ? 'data-start-indexv' : 'data-previous-indexv';
- return parseInt( stack.getAttribute( attributeName ) || 0, 10 );
- }
- return 0;
- }
- /**
- * Checks if the current or specified slide is vertical
- * (nested within another slide).
- *
- * @param {HTMLElement} [slide=currentSlide] The slide to check
- * orientation of
- * @return {Boolean}
- */
- function isVerticalSlide( slide = currentSlide ) {
- return slide && slide.parentNode && !!slide.parentNode.nodeName.match( /section/i );
- }
- /**
- * Checks if the current or specified slide is a stack containing
- * vertical slides.
- *
- * @param {HTMLElement} [slide=currentSlide]
- * @return {Boolean}
- */
- function isVerticalStack( slide = currentSlide ) {
- return slide.classList.contains( '.stack' ) || slide.querySelector( 'section' ) !== null;
- }
- /**
- * 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 presentation. 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;
- }
- /**
- * Enters the paused mode which fades everything on screen to
- * black.
- */
- function pause() {
- if( config.pause ) {
- const wasPaused = dom.wrapper.classList.contains( 'paused' );
- cancelAutoSlide();
- dom.wrapper.classList.add( 'paused' );
- if( wasPaused === false ) {
- dispatchEvent({ type: 'paused' });
- }
- }
- }
- /**
- * Exits from the paused mode.
- */
- function resume() {
- const wasPaused = dom.wrapper.classList.contains( 'paused' );
- dom.wrapper.classList.remove( 'paused' );
- cueAutoSlide();
- if( wasPaused ) {
- dispatchEvent({ type: '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.
- *
- * @return {Boolean}
- */
- function isPaused() {
- return dom.wrapper.classList.contains( 'paused' );
- }
- /**
- * Toggles visibility of the jump-to-slide UI.
- */
- function toggleJumpToSlide( override ) {
- if( typeof override === 'boolean' ) {
- override ? jumpToSlide.show() : jumpToSlide.hide();
- }
- else {
- jumpToSlide.isVisible() ? jumpToSlide.hide() : jumpToSlide.show();
- }
- }
- /**
- * Toggles the auto slide mode on and off.
- *
- * @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.
- *
- * @return {Boolean}
- */
- function isAutoSliding() {
- return !!( autoSlide && !autoSlidePaused );
- }
- /**
- * Steps from the current point in the presentation to the
- * slide which matches the specified horizontal and vertical
- * indices.
- *
- * @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
- * @param {number} [origin] Origin for use in multimaster environments
- */
- function slide( h, v, f, origin ) {
- // Dispatch an event before the slide
- const slidechange = dispatchEvent({
- type: 'beforeslidechange',
- data: {
- indexh: h === undefined ? indexh : h,
- indexv: v === undefined ? indexv : v,
- origin
- }
- });
- // Abort if this slide change was prevented by an event listener
- if( slidechange.defaultPrevented ) return;
- // Remember where we were at before
- previousSlide = currentSlide;
- // Query all horizontal slides in the deck
- const horizontalSlides = dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR );
- // If we're in scroll mode, we scroll the target slide into view
- // instead of running our standard slide transition
- if( scrollView.isActive() ) {
- const scrollToSlide = scrollView.getSlideByIndices( h, v );
- if( scrollToSlide ) scrollView.scrollToSlide( scrollToSlide );
- return;
- }
- // 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
- 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 );
- }
- // Remember the state before this slide
- const stateBefore = state.concat();
- // Reset the state array
- state.length = 0;
- let indexhBefore = indexh || 0,
- indexvBefore = indexv || 0;
- // 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 );
- // Dispatch an event if the slide changed
- let slideChanged = ( indexh !== indexhBefore || indexv !== indexvBefore );
- // Ensure that the previous slide is never the same as the current
- if( !slideChanged ) previousSlide = null;
- // Find the current horizontal slide and any possible vertical slides
- // within it
- let currentHorizontalSlide = horizontalSlides[ indexh ],
- currentVerticalSlides = currentHorizontalSlide.querySelectorAll( 'section' );
- // Indicate when we're on a vertical slide
- revealElement.classList.toggle( 'is-vertical-slide', currentVerticalSlides.length > 1 );
- // Store references to the previous and current slides
- currentSlide = currentVerticalSlides[ indexv ] || currentHorizontalSlide;
- let autoAnimateTransition = false;
- // Detect if we're moving between two auto-animated slides
- if( slideChanged && previousSlide && currentSlide && !overview.isActive() ) {
- transition = 'running';
- autoAnimateTransition = shouldAutoAnimateBetween( previousSlide, currentSlide, indexhBefore, indexvBefore );
- // If this is an auto-animated transition, we disable the
- // regular slide transition
- //
- // Note 20-03-2020:
- // This needs to happen before we update slide visibility,
- // otherwise transitions will still run in Safari.
- if( autoAnimateTransition ) {
- dom.slides.classList.add( 'disable-slide-transitions' )
- }
- }
- // Update the visibility of slides now that the indices have changed
- updateSlidesVisibility();
- layout();
- // Update the overview if it's currently active
- if( overview.isActive() ) {
- overview.update();
- }
- // Show fragment, if specified
- if( typeof f !== 'undefined' ) {
- fragments.goto( f );
- }
- // 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' );
- // Reset all slides upon navigate to home
- if( isFirstSlide() ) {
- // Launch async task
- setTimeout( () => {
- getVerticalStacks().forEach( slide => {
- setPreviousVerticalIndex( slide, 0 );
- } );
- }, 0 );
- }
- }
- // Apply the new state
- 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
- for( let j = 0; j < stateBefore.length; j++ ) {
- if( stateBefore[j] === state[i] ) {
- stateBefore.splice( j, 1 );
- continue stateLoop;
- }
- }
- dom.viewport.classList.add( state[i] );
- // Dispatch custom event matching the state's name
- dispatchEvent({ type: state[i] });
- }
- // Clean up the remains of the previous state
- while( stateBefore.length ) {
- dom.viewport.classList.remove( stateBefore.pop() );
- }
- if( slideChanged ) {
- dispatchSlideChanged( origin );
- }
- // Handle embedded content
- if( slideChanged || !previousSlide ) {
- slideContent.stopEmbeddedContent( previousSlide );
- slideContent.startEmbeddedContent( currentSlide );
- }
- // Announce the current slide contents to screen readers
- // Use animation frame to prevent getComputedStyle in getStatusText
- // from triggering layout mid-frame
- requestAnimationFrame( () => {
- announceStatus( getStatusText( currentSlide ) );
- });
- progress.update();
- controls.update();
- notes.update();
- backgrounds.update();
- backgrounds.updateParallax();
- slideNumber.update();
- fragments.update();
- // Update the URL hash
- location.writeURL();
- cueAutoSlide();
- // Auto-animation
- if( autoAnimateTransition ) {
- setTimeout( () => {
- dom.slides.classList.remove( 'disable-slide-transitions' );
- }, 0 );
- if( config.autoAnimate ) {
- // Run the auto-animation between our slides
- autoAnimate.run( previousSlide, currentSlide );
- }
- }
- }
- /**
- * Checks whether or not an auto-animation should take place between
- * the two given slides.
- *
- * @param {HTMLElement} fromSlide
- * @param {HTMLElement} toSlide
- * @param {number} indexhBefore
- * @param {number} indexvBefore
- *
- * @returns {boolean}
- */
- function shouldAutoAnimateBetween( fromSlide, toSlide, indexhBefore, indexvBefore ) {
- return fromSlide.hasAttribute( 'data-auto-animate' ) && toSlide.hasAttribute( 'data-auto-animate' ) &&
- fromSlide.getAttribute( 'data-auto-animate-id' ) === toSlide.getAttribute( 'data-auto-animate-id' ) &&
- !( ( indexh > indexhBefore || indexv > indexvBefore ) ? toSlide : fromSlide ).hasAttribute( 'data-auto-animate-restart' );
- }
- /**
- * Called anytime a new slide should be activated while in the scroll
- * view. The active slide is the page that occupies the most space in
- * the scrollable viewport.
- *
- * @param {number} pageIndex
- * @param {HTMLElement} slideElement
- */
- function setCurrentScrollPage( slideElement, h, v ) {
- let indexhBefore = indexh || 0;
- indexh = h;
- indexv = v;
- const slideChanged = currentSlide !== slideElement;
- previousSlide = currentSlide;
- currentSlide = slideElement;
- if( currentSlide && previousSlide ) {
- if( config.autoAnimate && shouldAutoAnimateBetween( previousSlide, currentSlide, indexhBefore, indexv ) ) {
- // Run the auto-animation between our slides
- autoAnimate.run( previousSlide, currentSlide );
- }
- }
- // Start or stop embedded content like videos and iframes
- if( slideChanged ) {
- if( previousSlide ) {
- slideContent.stopEmbeddedContent( previousSlide );
- slideContent.stopEmbeddedContent( previousSlide.slideBackgroundElement );
- }
- slideContent.startEmbeddedContent( currentSlide );
- slideContent.startEmbeddedContent( currentSlide.slideBackgroundElement );
- }
- requestAnimationFrame( () => {
- announceStatus( getStatusText( currentSlide ) );
- });
- dispatchSlideChanged();
- }
- /**
- * 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 all slide backgrounds
- backgrounds.create();
- // Write the current hash to the URL
- location.writeURL();
- if( config.sortFragmentsOnSync === true ) {
- fragments.sortAll();
- }
- controls.update();
- progress.update();
- updateSlidesVisibility();
- notes.update();
- notes.updateVisibility();
- overlay.update();
- backgrounds.update( true );
- slideNumber.update();
- slideContent.formatEmbeddedContent();
- // Start or stop embedded content depending on global config
- if( config.autoPlayMedia === false ) {
- slideContent.stopEmbeddedContent( currentSlide, { unloadIframes: false } );
- }
- else {
- slideContent.startEmbeddedContent( currentSlide );
- }
- if( overview.isActive() ) {
- overview.layout();
- }
- }
- /**
- * 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
- */
- function syncSlide( slide = currentSlide ) {
- backgrounds.sync( slide );
- fragments.sync( slide );
- slideContent.load( slide );
- backgrounds.update();
- notes.update();
- }
- /**
- * Resets all vertical slides so that only the first
- * is visible.
- */
- function resetVerticalSlides() {
- getHorizontalSlides().forEach( horizontalSlide => {
- Util.queryAll( horizontalSlide, 'section' ).forEach( ( verticalSlide, y ) => {
- 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( slides = getHorizontalSlides() ) {
- slides.forEach( ( slide, i ) => {
- // Insert the slide next to a randomly picked sibling slide
- // slide. This may cause the slide to insert before itself,
- // but that's not an issue.
- let beforeSlide = slides[ Math.floor( Math.random() * slides.length ) ];
- if( beforeSlide.parentNode === slide.parentNode ) {
- slide.parentNode.insertBefore( slide, beforeSlide );
- }
- // Randomize the order of vertical slides (if there are any)
- let verticalSlides = slide.querySelectorAll( 'section' );
- if( verticalSlides.length ) {
- shuffle( verticalSlides );
- }
- } );
- }
- /**
- * Updates one dimension of slides by showing the slide
- * with the specified index.
- *
- * @param {string} selector A CSS selector that will fetch
- * the group of slides we are working with
- * @param {number} index The index of the slide that should be
- * shown
- *
- * @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
- let slides = Util.queryAll( dom.wrapper, selector ),
- slidesLength = slides.length;
- let printMode = scrollView.isActive() || printView.isActive();
- let loopedForwards = false;
- let loopedBackwards = false;
- if( slidesLength ) {
- // Should the index loop?
- if( config.loop ) {
- if( index >= slidesLength ) loopedForwards = true;
- index %= slidesLength;
- if( index < 0 ) {
- index = slidesLength + index;
- loopedBackwards = true;
- }
- }
- // Enforce max and minimum index bounds
- index = Math.max( Math.min( index, slidesLength - 1 ), 0 );
- for( let i = 0; i < slidesLength; i++ ) {
- let element = slides[i];
- let reverse = config.rtl && !isVerticalSlide( element );
- // Avoid .remove() with multiple args for IE11 support
- element.classList.remove( 'past' );
- element.classList.remove( 'present' );
- element.classList.remove( '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' );
- if( config.fragments ) {
- // Show all fragments in prior slides
- showFragmentsIn( element );
- }
- }
- else if( i > index ) {
- // Any element subsequent to index is given the 'future' class
- element.classList.add( reverse ? 'past' : 'future' );
- if( config.fragments ) {
- // Hide all fragments in future slides
- hideFragmentsIn( element );
- }
- }
- // Update the visibility of fragments when a presentation loops
- // in either direction
- else if( i === index && config.fragments ) {
- if( loopedForwards ) {
- hideFragmentsIn( element );
- }
- else if( loopedBackwards ) {
- showFragmentsIn( element );
- }
- }
- }
- let slide = slides[index];
- let wasPresent = slide.classList.contains( 'present' );
- // Mark the current slide as present
- slide.classList.add( 'present' );
- slide.removeAttribute( 'hidden' );
- slide.removeAttribute( 'aria-hidden' );
- if( !wasPresent ) {
- // Dispatch an event indicating the slide is now visible
- dispatchEvent({
- target: slide,
- type: 'visible',
- bubbles: false
- });
- }
- // If this slide has a state associated with it, add it
- // onto the current state of the deck
- let slideState = slide.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;
- }
- /**
- * Shows all fragment elements within the given container.
- */
- function showFragmentsIn( container ) {
- Util.queryAll( container, '.fragment' ).forEach( fragment => {
- fragment.classList.add( 'visible' );
- fragment.classList.remove( 'current-fragment' );
- } );
- }
- /**
- * Hides all fragment elements within the given container.
- */
- function hideFragmentsIn( container ) {
- Util.queryAll( container, '.fragment.visible' ).forEach( fragment => {
- fragment.classList.remove( 'visible', 'current-fragment' );
- } );
- }
- /**
- * 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
- 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
- let viewDistance = overview.isActive() ? 10 : config.viewDistance;
- // Shorten the view distance on devices that typically have
- // less resources
- if( Device.isMobile ) {
- viewDistance = overview.isActive() ? 6 : config.mobileViewDistance;
- }
- // All slides need to be visible when exporting to PDF
- if( printView.isActive() ) {
- viewDistance = Number.MAX_VALUE;
- }
- for( let x = 0; x < horizontalSlidesLength; x++ ) {
- let horizontalSlide = horizontalSlides[x];
- let verticalSlides = Util.queryAll( horizontalSlide, '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 ) {
- distanceX = Math.abs( ( ( indexh || 0 ) - x ) % ( horizontalSlidesLength - viewDistance ) ) || 0;
- }
- // Show the horizontal slide if it's within the view distance
- if( distanceX < viewDistance ) {
- slideContent.load( horizontalSlide );
- }
- else {
- slideContent.unload( horizontalSlide );
- }
- if( verticalSlidesLength ) {
- let oy = getPreviousVerticalIndex( horizontalSlide );
- 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' );
- }
- }
- }
- /**
- * Determine what available routes there are for navigation.
- *
- * @return {{left: boolean, right: boolean, up: boolean, down: boolean}}
- */
- function availableRoutes({ includeFragments = false } = {}) {
- let horizontalSlides = dom.wrapper.querySelectorAll( HORIZONTAL_SLIDES_SELECTOR ),
- verticalSlides = dom.wrapper.querySelectorAll( VERTICAL_SLIDES_SELECTOR );
- 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;
- }
- if( verticalSlides.length > 1 ) {
- routes.up = true;
- routes.down = true;
- }
- }
- if ( horizontalSlides.length > 1 && config.navigationMode === 'linear' ) {
- routes.right = routes.right || routes.down;
- routes.left = routes.left || routes.up;
- }
- // If includeFragments is set, a route will be considered
- // available if either a slid OR fragment is available in
- // the given direction
- if( includeFragments === true ) {
- let fragmentRoutes = fragments.availableRoutes();
- routes.left = routes.left || fragmentRoutes.prev;
- routes.up = routes.up || fragmentRoutes.prev;
- routes.down = routes.down || fragmentRoutes.next;
- routes.right = routes.right || fragmentRoutes.next;
- }
- // Reverse horizontal controls for rtl
- if( config.rtl ) {
- let left = routes.left;
- routes.left = routes.right;
- routes.right = left;
- }
- return routes;
- }
- /**
- * Returns the number of past slides. This can be used as a global
- * flattened index for slides.
- *
- * @param {HTMLElement} [slide=currentSlide] The slide we're counting before
- *
- * @return {number} Past slide count
- */
- function getSlidePastCount( slide = currentSlide ) {
- let horizontalSlides = getHorizontalSlides();
- // The number of past slides
- let pastCount = 0;
- // Step through all slides and count the past ones
- mainLoop: for( let i = 0; i < horizontalSlides.length; i++ ) {
- let horizontalSlide = horizontalSlides[i];
- let verticalSlides = horizontalSlide.querySelectorAll( 'section' );
- for( let j = 0; j < verticalSlides.length; j++ ) {
- // Stop as soon as we arrive at the present
- if( verticalSlides[j] === slide ) {
- break mainLoop;
- }
- // Don't count slides with the "uncounted" class
- if( verticalSlides[j].dataset.visibility !== 'uncounted' ) {
- pastCount++;
- }
- }
- // Stop as soon as we arrive at the present
- if( horizontalSlide === slide ) {
- 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' ) {
- pastCount++;
- }
- }
- return pastCount;
- }
- /**
- * Returns a value ranging from 0-1 that represents
- * how far into the presentation we have navigated.
- *
- * @return {number}
- */
- function getProgress() {
- // The number of past and total slides
- let totalCount = getTotalSlides();
- let pastCount = getSlidePastCount();
- if( currentSlide ) {
- 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 ) {
- 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)
- 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 );
- }
- /**
- * Retrieves the h/v location and fragment of the current,
- * or specified, slide.
- *
- * @param {HTMLElement} [slide] If specified, the returned
- * index will be for this slide rather than the currently
- * active one
- *
- * @return {{h: number, v: number, f: number}}
- */
- function getIndices( slide ) {
- // By default, return the current indices
- let h = indexh,
- v = indexv,
- f;
- // If a slide is specified, return the indices of that slide
- if( slide ) {
- // In scroll mode the original h/x index is stored on the slide
- if( scrollView.isActive() ) {
- h = parseInt( slide.getAttribute( 'data-index-h' ), 10 );
- if( slide.getAttribute( 'data-index-v' ) ) {
- v = parseInt( slide.getAttribute( 'data-index-v' ), 10 );
- }
- }
- else {
- let isVertical = isVerticalSlide( slide );
- let slideh = isVertical ? slide.parentNode : slide;
- // Select all horizontal slides
- let horizontalSlides = getHorizontalSlides();
- // Now that we know which the horizontal slide is, get its index
- h = Math.max( horizontalSlides.indexOf( slideh ), 0 );
- // Assume we're not vertical
- v = undefined;
- // If this is a vertical slide, grab the vertical index
- if( isVertical ) {
- v = Math.max( Util.queryAll( slide.parentNode, 'section' ).indexOf( slide ), 0 );
- }
- }
- }
- if( !slide && currentSlide ) {
- let hasFragments = currentSlide.querySelectorAll( '.fragment' ).length > 0;
- if( hasFragments ) {
- 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;
- }
- }
- }
- return { h, v, f };
- }
- /**
- * Retrieves all slides in this presentation.
- */
- function getSlides() {
- return Util.queryAll( dom.wrapper, 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 Util.queryAll( dom.wrapper, HORIZONTAL_SLIDES_SELECTOR );
- }
- /**
- * Returns all vertical slides that exist within this deck.
- */
- function getVerticalSlides() {
- return Util.queryAll( dom.wrapper, '.slides>section>section' );
- }
- /**
- * Returns all vertical stacks (each stack can contain multiple slides).
- */
- function getVerticalStacks() {
- return Util.queryAll( dom.wrapper, 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;
- }
- /**
- * Returns an array of objects where each object represents the
- * attributes on its respective slide.
- */
- function getSlidesAttributes() {
- return getSlides().map( slide => {
- let attributes = {};
- for( let i = 0; i < slide.attributes.length; i++ ) {
- let attribute = slide.attributes[ i ];
- attributes[ attribute.name ] = attribute.value;
- }
- return attributes;
- } );
- }
- /**
- * Retrieves the total number of slides in this presentation.
- *
- * @return {number}
- */
- function getTotalSlides() {
- return getSlides().length;
- }
- /**
- * Returns the slide element matching the specified index.
- *
- * @return {HTMLElement}
- */
- function getSlide( x, y ) {
- let horizontalSlide = getHorizontalSlides()[ x ];
- let verticalSlides = horizontalSlide && horizontalSlide.querySelectorAll( 'section' );
- if( verticalSlides && verticalSlides.length && typeof y === 'number' ) {
- 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.
- *
- * @param {mixed} x Horizontal background index OR a slide
- * HTML element
- * @param {number} y Vertical background index
- * @return {(HTMLElement[]|*)}
- */
- function getSlideBackground( x, y ) {
- let slide = typeof x === 'number' ? getSlide( x, y ) : x;
- if( slide ) {
- return slide.slideBackgroundElement;
- }
- return undefined;
- }
- /**
- * Retrieves the current state of the presentation as
- * an object. This state can then be restored at any
- * time.
- *
- * @return {{indexh: number, indexv: number, indexf: number, paused: boolean, overview: boolean}}
- */
- function getState() {
- let indices = getIndices();
- return {
- indexh: indices.h,
- indexv: indices.v,
- indexf: indices.f,
- paused: isPaused(),
- overview: overview.isActive(),
- ...overlay.getState()
- };
- }
- /**
- * Restores the presentation to the given state.
- *
- * @param {object} state As generated by getState()
- * @see {@link getState} generates the parameter `state`
- */
- function setState( state ) {
- if( typeof state === 'object' ) {
- slide( Util.deserialize( state.indexh ), Util.deserialize( state.indexv ), Util.deserialize( state.indexf ) );
- let pausedFlag = Util.deserialize( state.paused ),
- overviewFlag = Util.deserialize( state.overview );
- if( typeof pausedFlag === 'boolean' && pausedFlag !== isPaused() ) {
- togglePause( pausedFlag );
- }
- if( typeof overviewFlag === 'boolean' && overviewFlag !== overview.isActive() ) {
- overview.toggle( overviewFlag );
- }
- overlay.setState( state );
- }
- }
- /**
- * Cues a new automated slide if enabled in the config.
- */
- function cueAutoSlide() {
- cancelAutoSlide();
- if( currentSlide && config.autoSlide !== false ) {
- let fragment = currentSlide.querySelector( '.current-fragment[data-autoslide]' );
- let fragmentAutoSlide = fragment ? fragment.getAttribute( 'data-autoslide' ) : null;
- let parentAutoSlide = currentSlide.parentNode ? currentSlide.parentNode.getAttribute( 'data-autoslide' ) : null;
- let slideAutoSlide = currentSlide.getAttribute( 'data-autoslide' );
- // 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
- // length of that media. Not applicable if the slide
- // is divided up into fragments.
- // playbackRate is accounted for in the duration.
- if( currentSlide.querySelectorAll( '.fragment' ).length === 0 ) {
- Util.queryAll( currentSlide, 'video, audio' ).forEach( el => {
- if( el.hasAttribute( 'data-autoplay' ) ) {
- if( autoSlide && (el.duration * 1000 / el.playbackRate ) > autoSlide ) {
- autoSlide = ( el.duration * 1000 / el.playbackRate ) + 1000;
- }
- }
- } );
- }
- }
- // 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
- if( autoSlide && !autoSlidePaused && !isPaused() && !overview.isActive() && ( !isLastSlide() || fragments.availableRoutes().next || config.loop === true ) ) {
- 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({ type: 'autoslidepaused' });
- clearTimeout( autoSlideTimeout );
- if( autoSlidePlayer ) {
- autoSlidePlayer.setPlaying( false );
- }
- }
- }
- function resumeAutoSlide() {
- if( autoSlide && autoSlidePaused ) {
- autoSlidePaused = false;
- dispatchEvent({ type: 'autoslideresumed' });
- cueAutoSlide();
- }
- }
- function navigateLeft({skipFragments=false}={}) {
- navigationHistory.hasNavigatedHorizontally = true;
- // Scroll view navigation is handled independently
- if( scrollView.isActive() ) return scrollView.prev();
- // Reverse for RTL
- if( config.rtl ) {
- if( ( overview.isActive() || skipFragments || fragments.next() === false ) && availableRoutes().left ) {
- slide( indexh + 1, config.navigationMode === 'grid' ? indexv : undefined );
- }
- }
- // Normal navigation
- else if( ( overview.isActive() || skipFragments || fragments.prev() === false ) && availableRoutes().left ) {
- slide( indexh - 1, config.navigationMode === 'grid' ? indexv : undefined );
- }
- }
- function navigateRight({skipFragments=false}={}) {
- navigationHistory.hasNavigatedHorizontally = true;
- // Scroll view navigation is handled independently
- if( scrollView.isActive() ) return scrollView.next();
- // Reverse for RTL
- if( config.rtl ) {
- if( ( overview.isActive() || skipFragments || fragments.prev() === false ) && availableRoutes().right ) {
- slide( indexh - 1, config.navigationMode === 'grid' ? indexv : undefined );
- }
- }
- // Normal navigation
- else if( ( overview.isActive() || skipFragments || fragments.next() === false ) && availableRoutes().right ) {
- slide( indexh + 1, config.navigationMode === 'grid' ? indexv : undefined );
- }
- }
- function navigateUp({skipFragments=false}={}) {
- // Scroll view navigation is handled independently
- if( scrollView.isActive() ) return scrollView.prev();
- // Prioritize hiding fragments
- if( ( overview.isActive() || skipFragments || fragments.prev() === false ) && availableRoutes().up ) {
- slide( indexh, indexv - 1 );
- }
- }
- function navigateDown({skipFragments=false}={}) {
- navigationHistory.hasNavigatedVertically = true;
- // Scroll view navigation is handled independently
- if( scrollView.isActive() ) return scrollView.next();
- // Prioritize revealing fragments
- if( ( overview.isActive() || skipFragments || fragments.next() === false ) && availableRoutes().down ) {
- slide( indexh, indexv + 1 );
- }
- }
- /**
- * Navigates backwards, prioritized in the following order:
- * 1) Previous fragment
- * 2) Previous vertical slide
- * 3) Previous horizontal slide
- */
- function navigatePrev({skipFragments=false}={}) {
- // Scroll view navigation is handled independently
- if( scrollView.isActive() ) return scrollView.prev();
- // Prioritize revealing fragments
- if( skipFragments || fragments.prev() === false ) {
- if( availableRoutes().up ) {
- navigateUp({skipFragments});
- }
- else {
- // Fetch the previous horizontal slide, if there is one
- let previousSlide;
- if( config.rtl ) {
- previousSlide = Util.queryAll( dom.wrapper, HORIZONTAL_SLIDES_SELECTOR + '.future' ).pop();
- }
- else {
- previousSlide = Util.queryAll( dom.wrapper, HORIZONTAL_SLIDES_SELECTOR + '.past' ).pop();
- }
- // When going backwards and arriving on a stack we start
- // at the bottom of the stack
- if( previousSlide && previousSlide.classList.contains( 'stack' ) ) {
- let v = ( previousSlide.querySelectorAll( 'section' ).length - 1 ) || undefined;
- let h = indexh - 1;
- slide( h, v );
- }
- else if( config.rtl ) {
- navigateRight({skipFragments});
- }
- else {
- navigateLeft({skipFragments});
- }
- }
- }
- }
- /**
- * The reverse of #navigatePrev().
- */
- function navigateNext({skipFragments=false}={}) {
- navigationHistory.hasNavigatedHorizontally = true;
- navigationHistory.hasNavigatedVertically = true;
- // Scroll view navigation is handled independently
- if( scrollView.isActive() ) return scrollView.next();
- // Prioritize revealing fragments
- if( skipFragments || fragments.next() === false ) {
- 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
- if( routes.down && routes.right && config.loop && isLastVerticalSlide() ) {
- routes.down = false;
- }
- if( routes.down ) {
- navigateDown({skipFragments});
- }
- else if( config.rtl ) {
- navigateLeft({skipFragments});
- }
- else {
- navigateRight({skipFragments});
- }
- }
- }
- // --------------------------------------------------------------------//
- // ----------------------------- EVENTS -------------------------------//
- // --------------------------------------------------------------------//
- /**
- * Called by all event handlers that are based on user
- * input.
- *
- * @param {object} [event]
- */
- function onUserInput( event ) {
- if( config.autoSlideStoppable ) {
- pauseAutoSlide();
- }
- }
- /**
- * Listener for post message events posted to this window.
- */
- function onPostMessage( event ) {
- 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 ) {
- 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' );
- }
- }
- }
- }
- /**
- * Event listener for transition end on the current slide.
- *
- * @param {object} [event]
- */
- function onTransitionEnd( event ) {
- if( transition === 'running' && /section/gi.test( event.target.nodeName ) ) {
- transition = 'idle';
- dispatchEvent({
- type: 'slidetransitionend',
- data: { indexh, indexv, previousSlide, currentSlide }
- });
- }
- }
- /**
- * A global listener for all click events inside of the
- * .slides container.
- *
- * @param {object} [event]
- */
- function onSlidesClicked( event ) {
- const anchor = Util.closest( event.target, 'a[href^="#"]' );
- // If a hash link is clicked, we find the target slide
- // and navigate to it. We previously relied on 'hashchange'
- // for links like these but that prevented media with
- // audio tracks from playing in mobile browsers since it
- // wasn't considered a direct interaction with the document.
- if( anchor ) {
- const hash = anchor.getAttribute( 'href' );
- const indices = location.getIndicesFromHash( hash );
- if( indices ) {
- Reveal.slide( indices.h, indices.v, indices.f );
- event.preventDefault();
- }
- }
- }
- /**
- * Handler for the window level 'resize' event.
- *
- * @param {object} [event]
- */
- function onWindowResize( event ) {
- layout();
- }
- /**
- * Handle for the window level 'visibilitychange' event.
- *
- * @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
- if( document.hidden === false && document.activeElement !== document.body ) {
- // Not all elements support .blur() - SVGs among them.
- if( typeof document.activeElement.blur === 'function' ) {
- document.activeElement.blur();
- }
- document.body.focus();
- }
- }
- /**
- * Handler for the document level 'fullscreenchange' event.
- *
- * @param {object} [event]
- */
- function onFullscreenChange( event ) {
- let element = document.fullscreenElement || document.webkitFullscreenElement;
- if( element === dom.wrapper ) {
- event.stopImmediatePropagation();
- // Timeout to avoid layout shift in Safari
- setTimeout( () => {
- Reveal.layout();
- Reveal.focus.focus(); // focus.focus :'(
- }, 1 );
- }
- }
- /**
- * Handles click on the auto-sliding controls element.
- *
- * @param {object} [event]
- */
- function onAutoSlidePlayerClick( event ) {
- // Replay
- if( isLastSlide() && config.loop === false ) {
- slide( 0, 0 );
- resumeAutoSlide();
- }
- // Resume
- else if( autoSlidePaused ) {
- resumeAutoSlide();
- }
- // Pause
- else {
- pauseAutoSlide();
- }
- }
- // --------------------------------------------------------------------//
- // ------------------------------- API --------------------------------//
- // --------------------------------------------------------------------//
- // The public reveal.js API
- const API = {
- VERSION,
- initialize,
- configure,
- destroy,
- sync,
- syncSlide,
- syncFragments: fragments.sync.bind( fragments ),
- // Navigation methods
- slide,
- left: navigateLeft,
- right: navigateRight,
- up: navigateUp,
- down: navigateDown,
- prev: navigatePrev,
- next: navigateNext,
- // Navigation aliases
- navigateLeft, navigateRight, navigateUp, navigateDown, navigatePrev, navigateNext,
- // Fragment methods
- navigateFragment: fragments.goto.bind( fragments ),
- prevFragment: fragments.prev.bind( fragments ),
- nextFragment: fragments.next.bind( fragments ),
- // Event binding
- on,
- off,
- // Legacy event binding methods left in for backwards compatibility
- addEventListener: on,
- removeEventListener: off,
- // Forces an update in slide layout
- layout,
- // Randomizes the order of slides
- shuffle,
- // Returns an object with the available routes as booleans (left/right/top/bottom)
- availableRoutes,
- // Returns an object with the available fragments as booleans (prev/next)
- availableFragments: fragments.availableRoutes.bind( fragments ),
- // Toggles a help overlay with keyboard shortcuts
- toggleHelp: overlay.toggleHelp.bind( overlay ),
- // Toggles the overview mode on/off
- toggleOverview: overview.toggle.bind( overview ),
- // Toggles the scroll view on/off
- toggleScrollView: scrollView.toggle.bind( scrollView ),
- // Toggles the "black screen" mode on/off
- togglePause,
- // Toggles the auto slide mode on/off
- toggleAutoSlide,
- // Toggles visibility of the jump-to-slide UI
- toggleJumpToSlide,
- // Slide navigation checks
- isFirstSlide,
- isLastSlide,
- isLastVerticalSlide,
- isVerticalSlide,
- isVerticalStack,
- // State checks
- isPaused,
- isAutoSliding,
- isSpeakerNotes: notes.isSpeakerNotesWindow.bind( notes ),
- isOverview: overview.isActive.bind( overview ),
- isFocused: focus.isFocused.bind( focus ),
- isOverlayOpen: overlay.isOpen.bind( overlay ),
- isScrollView: scrollView.isActive.bind( scrollView ),
- isPrintView: printView.isActive.bind( printView ),
- // Checks if reveal.js has been loaded and is ready for use
- isReady: () => ready,
- // Slide preloading
- loadSlide: slideContent.load.bind( slideContent ),
- unloadSlide: slideContent.unload.bind( slideContent ),
- // Start/stop all media inside of the current slide
- startEmbeddedContent: () => slideContent.startEmbeddedContent( currentSlide ),
- stopEmbeddedContent: () => slideContent.stopEmbeddedContent( currentSlide, { unloadIframes: false } ),
- // Preview management
- showIframePreview: overlay.showIframePreview.bind( overlay ),
- showMediaPreview: overlay.showMediaPreview.bind( overlay ),
- showPreview: overlay.showIframePreview.bind( overlay ), // deprecated in favor of showIframePreview
- hidePreview: overlay.close.bind( overlay ),
- // Adds or removes all internal event listeners
- addEventListeners,
- removeEventListeners,
- dispatchEvent,
- // Facility for persisting and restoring the presentation state
- getState,
- setState,
- // Presentation progress on range of 0-1
- getProgress,
- // Returns the indices of the current, or specified, slide
- getIndices,
- // Returns an Array of key:value maps of the attributes of each
- // slide in the deck
- getSlidesAttributes,
- // Returns the number of slides that we have passed
- getSlidePastCount,
- // Returns the total number of slides
- getTotalSlides,
- // Returns the slide element at the specified index
- getSlide,
- // Returns the previous slide element, may be null
- getPreviousSlide: () => previousSlide,
- // Returns the current slide element
- getCurrentSlide: () => currentSlide,
- // Returns the slide background element at the specified index
- getSlideBackground,
- // Returns the speaker notes string for a slide, or null
- getSlideNotes: notes.getSlideNotes.bind( notes ),
- // Returns an Array of all slides
- getSlides,
- // Returns an array with all horizontal/vertical slides in the deck
- getHorizontalSlides,
- getVerticalSlides,
- // Checks if the presentation contains two or more horizontal
- // and vertical slides
- hasHorizontalSlides,
- hasVerticalSlides,
- // Checks if the deck has navigated on either axis at least once
- hasNavigatedHorizontally: () => navigationHistory.hasNavigatedHorizontally,
- hasNavigatedVertically: () => navigationHistory.hasNavigatedVertically,
- shouldAutoAnimateBetween,
- // Adds/removes a custom key binding
- addKeyBinding: keyboard.addKeyBinding.bind( keyboard ),
- removeKeyBinding: keyboard.removeKeyBinding.bind( keyboard ),
- // Programmatically triggers a keyboard event
- triggerKey: keyboard.triggerKey.bind( keyboard ),
- // Registers a new shortcut to include in the help overlay
- registerKeyboardShortcut: keyboard.registerKeyboardShortcut.bind( keyboard ),
- getComputedSlideSize,
- setCurrentScrollPage,
- // 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 map
- getQueryHash: Util.getQueryHash,
- // Returns the path to the current slide as represented in the URL
- getSlidePath: location.getHash.bind( location ),
- // Returns reveal.js DOM elements
- getRevealElement: () => revealElement,
- getSlidesElement: () => dom.slides,
- getViewportElement: () => dom.viewport,
- getBackgroundsElement: () => backgrounds.element,
- // API for registering and retrieving plugins
- registerPlugin: plugins.registerPlugin.bind( plugins ),
- hasPlugin: plugins.hasPlugin.bind( plugins ),
- getPlugin: plugins.getPlugin.bind( plugins ),
- getPlugins: plugins.getRegisteredPlugins.bind( plugins )
- };
- // Our internal API which controllers have access to
- Util.extend( Reveal, {
- ...API,
- // Methods for announcing content to screen readers
- announceStatus,
- getStatusText,
- // Controllers
- focus,
- scroll: scrollView,
- progress,
- controls,
- location,
- overview,
- keyboard,
- fragments,
- backgrounds,
- slideContent,
- slideNumber,
- onUserInput,
- closeOverlay: overlay.close.bind( overlay ),
- updateSlidesVisibility,
- layoutSlideContents,
- transformSlides,
- cueAutoSlide,
- cancelAutoSlide
- } );
- return API;
- };
|