2020-03-31 11:09:44 +00:00
|
|
|
import { supportsHistoryAPI } from '../utils/device.js'
|
|
|
|
|
2020-03-10 20:08:11 +00:00
|
|
|
/**
|
2020-03-11 07:13:53 +00:00
|
|
|
* Reads and writes the URL based on reveal.js' current state.
|
2020-03-10 20:08:11 +00:00
|
|
|
*/
|
|
|
|
export default class Location {
|
|
|
|
|
|
|
|
constructor( Reveal ) {
|
|
|
|
|
|
|
|
this.Reveal = Reveal;
|
|
|
|
|
2020-03-10 20:30:39 +00:00
|
|
|
// Delays updates to the URL due to a Chrome thumbnailer bug
|
|
|
|
this.writeURLTimeout = 0;
|
|
|
|
|
2020-04-22 09:11:14 +00:00
|
|
|
this.onWindowHashChange = this.onWindowHashChange.bind( this );
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
bind() {
|
|
|
|
|
|
|
|
window.addEventListener( 'hashchange', this.onWindowHashChange, false );
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
unbind() {
|
|
|
|
|
|
|
|
window.removeEventListener( 'hashchange', this.onWindowHashChange, false );
|
|
|
|
|
2020-03-10 20:30:39 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Reads the current URL (hash) and navigates accordingly.
|
|
|
|
*/
|
|
|
|
readURL() {
|
|
|
|
|
|
|
|
let config = this.Reveal.getConfig();
|
|
|
|
let indices = this.Reveal.getIndices();
|
|
|
|
let currentSlide = this.Reveal.getCurrentSlide();
|
|
|
|
|
|
|
|
let hash = window.location.hash;
|
|
|
|
|
|
|
|
// Attempt to parse the hash as either an index or name
|
|
|
|
let bits = hash.slice( 2 ).split( '/' ),
|
2020-04-22 09:11:14 +00:00
|
|
|
name = hash.replace( /#\/?/gi, '' );
|
2020-03-10 20:30:39 +00:00
|
|
|
|
|
|
|
// 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 ) {
|
|
|
|
let element;
|
|
|
|
|
2020-04-22 09:11:14 +00:00
|
|
|
let f;
|
|
|
|
|
|
|
|
// Parse named links with fragments (#/named-link/2)
|
|
|
|
if( /\/[-\d]+$/g.test( name ) ) {
|
|
|
|
f = parseInt( name.split( '/' ).pop(), 10 );
|
|
|
|
f = isNaN(f) ? undefined : f;
|
|
|
|
name = name.split( '/' ).shift();
|
|
|
|
}
|
|
|
|
|
2020-03-10 20:30:39 +00:00
|
|
|
// Ensure the named link is a valid HTML ID attribute
|
|
|
|
try {
|
|
|
|
element = document.getElementById( decodeURIComponent( name ) );
|
|
|
|
}
|
|
|
|
catch ( error ) { }
|
|
|
|
|
|
|
|
// Ensure that we're not already on a slide with the same name
|
|
|
|
let isSameNameAsCurrentSlide = currentSlide ? currentSlide.getAttribute( 'id' ) === name : false;
|
|
|
|
|
|
|
|
if( element ) {
|
|
|
|
// If the slide exists and is not the current slide...
|
2020-04-22 09:11:14 +00:00
|
|
|
if ( !isSameNameAsCurrentSlide || typeof f !== 'undefined' ) {
|
2020-03-10 20:30:39 +00:00
|
|
|
// ...find the position of the named slide and navigate to it
|
2020-04-22 09:11:14 +00:00
|
|
|
let slideIndices = this.Reveal.getIndices( element );
|
|
|
|
this.Reveal.slide( slideIndices.h, slideIndices.v, f );
|
2020-03-10 20:30:39 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
// If the slide doesn't exist, navigate to the current slide
|
|
|
|
else {
|
|
|
|
this.Reveal.slide( indices.h || 0, indices.v || 0 );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
let hashIndexBase = config.hashOneBasedIndex ? 1 : 0;
|
|
|
|
|
|
|
|
// Read the index components of the hash
|
|
|
|
let h = ( parseInt( bits[0], 10 ) - hashIndexBase ) || 0,
|
|
|
|
v = ( parseInt( bits[1], 10 ) - hashIndexBase ) || 0,
|
|
|
|
f;
|
|
|
|
|
|
|
|
if( config.fragmentInURL ) {
|
|
|
|
f = parseInt( bits[2], 10 );
|
|
|
|
if( isNaN( f ) ) {
|
|
|
|
f = undefined;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
if( h !== indices.h || v !== indices.v || f !== undefined ) {
|
|
|
|
this.Reveal.slide( h, v, f );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Updates the page URL (hash) to reflect the current
|
|
|
|
* state.
|
|
|
|
*
|
|
|
|
* @param {number} delay The time in ms to wait before
|
|
|
|
* writing the hash
|
|
|
|
*/
|
|
|
|
writeURL( delay ) {
|
|
|
|
|
|
|
|
let config = this.Reveal.getConfig();
|
|
|
|
let currentSlide = this.Reveal.getCurrentSlide();
|
|
|
|
|
|
|
|
// Make sure there's never more than one timeout running
|
|
|
|
clearTimeout( this.writeURLTimeout );
|
|
|
|
|
|
|
|
// If a delay is specified, timeout this call
|
|
|
|
if( typeof delay === 'number' ) {
|
|
|
|
this.writeURLTimeout = setTimeout( this.writeURL, delay );
|
|
|
|
}
|
|
|
|
else if( currentSlide ) {
|
|
|
|
// If we're configured to push to history OR the history
|
|
|
|
// API is not avaialble.
|
2020-03-31 11:09:44 +00:00
|
|
|
if( config.history || supportsHistoryAPI === false ) {
|
2020-03-10 20:30:39 +00:00
|
|
|
window.location.hash = this.getHash();
|
|
|
|
}
|
|
|
|
// If we're configured to reflect the current slide in the
|
|
|
|
// URL without pushing to history.
|
|
|
|
else if( config.hash ) {
|
|
|
|
window.history.replaceState( null, null, '#' + this.getHash() );
|
|
|
|
}
|
|
|
|
// 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 );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-03-10 20:08:11 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return a hash URL that will resolve to the given slide location.
|
|
|
|
*
|
|
|
|
* @param {HTMLElement} [slide=currentSlide] The slide to link to
|
|
|
|
*/
|
2020-03-10 20:30:39 +00:00
|
|
|
getHash( slide ) {
|
2020-03-10 20:08:11 +00:00
|
|
|
|
|
|
|
let url = '/';
|
|
|
|
|
|
|
|
// Attempt to create a named link based on the slide's ID
|
2020-03-10 20:30:39 +00:00
|
|
|
let s = slide || this.Reveal.getCurrentSlide();
|
|
|
|
let id = s ? s.getAttribute( 'id' ) : null;
|
2020-03-10 20:08:11 +00:00
|
|
|
if( id ) {
|
|
|
|
id = encodeURIComponent( id );
|
|
|
|
}
|
|
|
|
|
|
|
|
let index = this.Reveal.getIndices( slide );
|
|
|
|
if( !this.Reveal.getConfig().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
|
2020-04-22 09:11:14 +00:00
|
|
|
if( typeof id === 'string' && id.length ) {
|
2020-03-10 20:08:11 +00:00
|
|
|
url = '/' + id;
|
2020-04-22 09:11:14 +00:00
|
|
|
|
|
|
|
// If there is also a fragment, append that at the end
|
|
|
|
// of the named link, like: #/named-link/2
|
|
|
|
if( index.f >= 0 ) url += '/' + index.f;
|
2020-03-10 20:08:11 +00:00
|
|
|
}
|
|
|
|
// Otherwise use the /h/v index
|
|
|
|
else {
|
|
|
|
let hashIndexBase = this.Reveal.getConfig().hashOneBasedIndex ? 1 : 0;
|
2020-04-22 09:11:14 +00:00
|
|
|
if( index.h > 0 || index.v > 0 || index.f >= 0 ) url += index.h + hashIndexBase;
|
|
|
|
if( index.v > 0 || index.f >= 0 ) url += '/' + (index.v + hashIndexBase );
|
|
|
|
if( index.f >= 0 ) url += '/' + index.f;
|
2020-03-10 20:08:11 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return url;
|
|
|
|
|
|
|
|
}
|
|
|
|
|
2020-04-22 09:11:14 +00:00
|
|
|
/**
|
|
|
|
* Handler for the window level 'hashchange' event.
|
|
|
|
*
|
|
|
|
* @param {object} [event]
|
|
|
|
*/
|
|
|
|
onWindowHashChange( event ) {
|
|
|
|
|
|
|
|
this.readURL();
|
|
|
|
|
|
|
|
}
|
|
|
|
|
2020-03-10 20:08:11 +00:00
|
|
|
}
|