import * as DOM from "../dom/DOM" import { hexToRgb, mergeData, classMixin, isTrue, trace, addTraceHandler } from "../core/Util"; import { easeInOutQuint, easeOutStrong } from "../animation/Ease"; import Message from "../ui/Message" import { Language, fallback, loadLanguage } from "../language/Language" import { I18NMixins } from "../language/I18NMixins"; import Events from "../core/Events"; import { makeConfig } from "../core/ConfigFactory" import { TimelineConfig } from "../core/TimelineConfig" import { TimeNav } from "../timenav/TimeNav" import * as Browser from "../core/Browser" import { Animate } from "../animation/Animate" import { StorySlider } from "../slider/StorySlider" import { MenuBar } from "../ui/MenuBar" import { loadCSS, loadJS } from "../core/Load"; let script_src_url = null; if (document) { let script_tags = document.getElementsByTagName('script'); if (script_tags && script_tags.length > 0) { script_src_url = script_tags[script_tags.length - 1].src; } } function make_keydown_handler(timeline) { return function(event) { if (timeline.config) { var keyName = event.key; var currentSlide = timeline._getSlideIndex(self.current_id); var _n = timeline.config.events.length - 1; var lastSlide = timeline.config.title ? _n + 1 : _n; var firstSlide = 0; if (keyName == 'ArrowLeft') { if (currentSlide != firstSlide) { timeline.goToPrev(); } } else if (keyName == 'ArrowRight') { if (currentSlide != lastSlide) { timeline.goToNext(); } } } } } /** * Primary entry point for using TimelineJS. * @constructor * @param {HTMLElement|string} elem - the HTML element, or its ID, to which * the Timeline should be bound * @param {object|String} - a JavaScript object conforming to the TimelineJS * configuration format, or a String which is the URL for a Google Sheets document * or JSON configuration file which Timeline will retrieve and parse into a JavaScript object. * NOTE: do not pass a JSON String for this. TimelineJS doesn't try to distinguish a * JSON string from a URL string. If you have a JSON String literal, parse it using * `JSON.parse` before passing it to the constructor. * * @param {object} [options] - a JavaScript object specifying * presentation options */ class Timeline { constructor(elem, data, options) { if (!options) { options = {} } this.ready = false; this._el = { container: DOM.get(elem), storyslider: {}, timenav: {}, menubar: {} }; if (options.lang && !options.language) { options.language = options.lang; } /** @type {Language} */ this.language = fallback; /** @type {StorySlider} */ this._storyslider = {}; /** @type {TimeNav} */ this._timenav = {}; /** @type {MenuBar} */ this._menubar = {}; // Loaded State this._loaded = { storyslider: false, timenav: false }; /** @type {TimelineConfig} */ this.config = null; this.options = { script_path: "https://cdn.knightlab.com/libs/timeline3/latest/js/", // as good a default as any height: this._el.container.offsetHeight, width: this._el.container.offsetWidth, debug: false, font: 'default', is_embed: false, is_full_embed: false, hash_bookmark: false, default_bg_color: { r: 255, g: 255, b: 255 }, scale_factor: 2, // How many screen widths wide should the timeline be layout: "landscape", // portrait or landscape timenav_position: "bottom", // timeline on top or bottom optimal_tick_width: 60, // optimal distance (in pixels) between ticks on axis base_class: "tl-timeline", // removing tl-timeline will break all default stylesheets... timenav_height: null, timenav_height_percentage: 25, // Overrides timenav height as a percentage of the screen timenav_mobile_height_percentage: 40, // timenav height as a percentage on mobile devices timenav_height_min: 175, // Minimum timenav height marker_height_min: 30, // Minimum Marker Height marker_width_min: 100, // Minimum Marker Width marker_padding: 5, // Top Bottom Marker Padding start_at_slide: 0, start_at_end: false, menubar_height: 0, skinny_size: 650, medium_size: 800, use_bc: false, // Use declared suffix on dates earlier than 0 // animation duration: 1000, ease: easeInOutQuint, // interaction dragging: true, trackResize: true, map_type: "stamen:toner-lite", slide_padding_lr: 100, // padding on slide of slide slide_default_fade: "0%", // landscape fade zoom_sequence: [0.5, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89], // Array of Fibonacci numbers for TimeNav zoom levels language: "en", ga_measurement_id: null, ga_property_id: null, track_events: ['back_to_start', 'nav_next', 'nav_previous', 'zoom_in', 'zoom_out'], theme: null, // sheets_proxy value should be suitable for simply postfixing with the Google Sheets CSV URL // as in include trailing slashes, or '?url=' or whatever. No support right now for anything but // postfixing. The default proxy should work in most cases, but only for TimelineJS sheets. sheets_proxy: 'https://sheets-proxy.knightlab.com/proxy/', soundcite: false, }; // Animation Objects this.animator_timenav = null; this.animator_storyslider = null; this.animator_menubar = null; // Ideally we'd set the language here, but we're bootstrapping and may hit problems // before we're able to load it. if it weren't a remote resource, we could probably // do it. this.message = new Message(this._el.container, { message_class: "tl-message-full" }); // Merge Options if (typeof(options.default_bg_color) == "string") { var parsed = hexToRgb(options.default_bg_color); // will clear it out if its invalid if (parsed) { options.default_bg_color = parsed; } else { delete options.default_bg_color trace("Invalid default background color. Ignoring."); } } mergeData(this.options, options); if (!(this.options.script_path)) { this.options.script_path = this.determineScriptPath() } if (options.soundcite) { this.on('ready', () => { trace("Loading Soundcite resources ") loadCSS('https://cdn.knightlab.com/libs/soundcite/latest/css/player.css') loadJS('https://cdn.knightlab.com/libs/soundcite/latest/js/soundcite.min.js') }) } // load font, theme this._loadStyles() document.addEventListener("keydown", make_keydown_handler(this)); window.addEventListener("resize", function(e) { this.updateDisplay(); }.bind(this)); if (this.options.debug) { addTraceHandler(console.log) } // Apply base class to container this._el.container.classList.add('tl-timeline'); this._el.container.setAttribute('tabindex', '0'); this._el.container.setAttribute('role', 'region'); this._el.container.setAttribute('aria-label', this._('aria_label_timeline')); if (this.options.is_embed) { this._el.container.classList.add('tl-timeline-embed'); } if (this.options.is_full_embed) { this._el.container.classList.add('tl-timeline-full-embed'); } this._loadLanguage(data); } _loadStyles() { let font_css_url = null, theme_css_url = null; if (this.options.font && ( this.options.font.indexOf('http') == 0 || this.options.font.match(/\.css$/))) { font_css_url = this.options.font } else if (this.options.font) { let fragment = '../css/fonts/font.' + this.options.font.toLowerCase() + '.css' font_css_url = new URL(fragment, this.options.script_path).toString() } if (font_css_url) { loadCSS(font_css_url) } if (this.options.theme && ( this.options.theme.indexOf('http') == 0 || this.options.theme.match(/\.css$/))) { theme_css_url = this.options.theme } else if (this.options.theme) { let fragment = '../css/themes/timeline.theme.' + this.options.theme.toLowerCase() + '.css' theme_css_url = new URL(fragment, this.options.script_path).toString() } if (theme_css_url) { loadCSS(theme_css_url) } } _loadLanguage(data) { try { var lang = this.options.language var script_path = this.options.script_path loadLanguage(lang, script_path).then((language) => { if (language) { this.language = language this.message.setLanguage(this.language) this.showMessage(this._('loading_timeline')) } else { this.showMessage(`Error loading ${lang}`) // but we will carry on using the fallback } this._initData(data) }) } catch (e) { this.showMessage(this._translateError(e)) } } /** * Initialize the data for this timeline. If data is a URL, pass it to ConfigFactory * to get a TimelineConfig; if data is a TimelineConfig, just use it; otherwise, * assume it's a JSON object in the right format, and wrap it in a new TimelineConfig. * @param {string|TimelineConfig|object} data */ _initData(data) { if (typeof data == 'string') { makeConfig(data, { callback: function(config) { this.setConfig(config); }.bind(this), sheets_proxy: this.options.sheets_proxy }); } else if (TimelineConfig == data.constructor) { this.setConfig(data); } else { this.setConfig(new TimelineConfig(data)); } } /** * Given an input, if it is a Timeline Error object, look up the * appropriate error in the current language and return it, optionally * with detail that also comes in the object. Alternatively, pass back * the input, which is expected to be a string ready to display. * @param {Error|string} e - an Error object which can be localized, * or a string message */ _translateError(e) { if (e.hasOwnProperty('stack')) { trace(e.stack); } if (e.message_key) { return this._(e.message_key) + (e.detail ? ' [' + e.detail + ']' : '') } return e; } /** * Display a message in the Timeline window. * @param {string} msg */ showMessage(msg) { if (this.message) { this.message.updateMessage(msg); } else { trace("No message display available.") trace(msg); } } /** * Not ideal, but if users don't specify the script path, we try to figure it out. * The script path is needed to load other languages */ determineScriptPath() { let src = null; if (script_src_url) { // did we get it when this loaded? src = script_src_url; } else { let script_tag = document.getElementById('timeline-script-tag') if (script_tag) { src = script_tag.src } } if (!src) { let script_tags = document.getElementsByTagName('script'); for (let index = script_tags.length - 1; index >= 0; index--) { if (script_tags[index].src) { src = script_tags[index].src break // if we haven't found anything else, use the latest loaded script } } } if (src) { // +1 to include the trailing slash or concatting for dynamic CSS load won't work. return src.substr(0, src.lastIndexOf('/') + 1); } return ''; } setConfig(config) { this.config = config; if (this.config.isValid()) { // don't validate if it's already problematic to avoid clutter this.config.validate(); this._validateOptions(); } if (this.config.isValid()) { try { if (document.readyState === 'loading') { // Loading hasn't finished yet document.addEventListener('DOMContentLoaded', this._onDataLoaded.bind(this)); } else { this._onDataLoaded(); } } catch (e) { this.showMessage("" + this._('error') + ": " + this._translateError(e)); } } else { var translated_errs = []; for (var i = 0, errs = this.config.getErrors(); i < errs.length; i++) { translated_errs.push(this._translateError(errs[i])); } this.showMessage("" + this._('error') + ": " + translated_errs.join('
')); // should we set 'self.ready'? if not, it won't resize, // but most resizing would only work // if more setup happens } } _onDataLoaded() { this.fire("dataloaded"); this._initLayout(); this._initEvents(); this._initAnalytics(); if (this.message) { this.message.hide(); } let callback = (entries, observer) => { if (entries.reduce((accum, curr) => accum || curr.isIntersecting, false)) { this.updateDisplay() } } let observer = new IntersectionObserver(callback.bind(this)) observer.observe(this._el.container) this.ready = true; this.fire("ready") } _initLayout() { this.message.removeFrom(this._el.container); this._el.container.innerHTML = ""; // Create Layout if (this.options.timenav_position == "top") { this._el.timenav = DOM.create('div', 'tl-timenav', this._el.container); this._el.menubar = DOM.create('div', 'tl-menubar', this._el.container); this._el.storyslider = DOM.create('div', 'tl-storyslider', this._el.container); } else { this._el.storyslider = DOM.create('div', 'tl-storyslider', this._el.container); this._el.timenav = DOM.create('div', 'tl-timenav', this._el.container); this._el.menubar = DOM.create('div', 'tl-menubar', this._el.container); } // Knight Lab Logo this._el.attribution = DOM.create('div', 'tl-attribution', this._el.container); this._el.attribution.innerHTML = "TimelineJS" // Initial Default Layout this.options.width = this._el.container.offsetWidth; this.options.height = this._el.container.offsetHeight; // this._el.storyslider.style.top = "1px"; // Set TimeNav Height this.options.timenav_height = this._calculateTimeNavHeight(this.options.timenav_height); // Create TimeNav this._timenav = new TimeNav(this._el.timenav, this.config, this.options, this.language); this._timenav.on('loaded', this._onTimeNavLoaded, this); this._timenav.options.height = this.options.timenav_height; this._timenav.init(); // intial_zoom cannot be applied before the timenav has been created if (this.options.initial_zoom) { // at this point, this.options refers to the merged set of options this.setZoom(this.options.initial_zoom); } // Create StorySlider this._storyslider = new StorySlider(this._el.storyslider, this.config, this.options, this.language); this._el.storyslider.setAttribute('role', 'group'); this._el.storyslider.setAttribute('aria-label', this._('aria_label_timeline_content')); this._storyslider.on('loaded', this._onStorySliderLoaded, this); this._storyslider.init(); // Create Menu Bar this._menubar = new MenuBar(this._el.menubar, this._el.container, this.options, this.getLanguage()); // LAYOUT if (this.options.layout == "portrait") { this.options.storyslider_height = (this.options.height - this.options.timenav_height - 1); } else { this.options.storyslider_height = (this.options.height - 1); } // Update Display this._updateDisplay(this._timenav.options.height, true, 2000); } _initEvents() { // TimeNav Events this._timenav.on('change', this._onTimeNavChange, this); this._timenav.on('zoomtoggle', this._onZoomToggle, this); this._timenav.on('visible_ticks_change', this._onVisibleTicksChange, this); // StorySlider Events this._storyslider.on('change', this._onSlideChange, this); this._storyslider.on('colorchange', this._onColorChange, this); this._storyslider.on('nav_next', this._onStorySliderNext, this); this._storyslider.on('nav_previous', this._onStorySliderPrevious, this); // Menubar Events this._menubar.on('zoom_in', this._onZoomIn, this); this._menubar.on('zoom_out', this._onZoomOut, this); this._menubar.on('forward_to_end', this._onForwardToEnd, this); this._menubar.on('back_to_start', this._onBackToStart, this); } _onColorChange(e) { this.fire("color_change", { unique_id: this.current_id }, this); } _onSlideChange(e) { if (this.current_id != e.unique_id) { this.current_id = e.unique_id; this._timenav.goToId(this.current_id); this._onChange(e); } } _onTimeNavChange(e) { if (this.current_id != e.unique_id) { this.current_id = e.unique_id; this._storyslider.goToId(this.current_id); this._onChange(e); } } _onZoomToggle(e) { if (e.zoom == "in") { this._menubar.toogleZoomIn(e.show); } else if (e.zoom == "out") { this._menubar.toogleZoomOut(e.show); } } _onChange(e) { this.fire("change", { unique_id: this.current_id }, this); if (this.options.hash_bookmark && this.current_id) { this._updateHashBookmark(this.current_id); } } _onVisibleTicksChange(e) { this._menubar.changeVisibleTicks(e.visible_ticks); } _onForwardToEnd(e) { this.goToEnd(); this.fire("forward_to_end", { unique_id: this.current_id }, this); } _onBackToStart(e) { this.goToStart(); this.fire("back_to_start", { unique_id: this.current_id }, this); } _onZoomIn(e) { this._timenav.zoomIn(); this.fire("zoom_in", { zoom_level: this._timenav.options.scale_factor }, this); } _onZoomOut(e) { this._timenav.zoomOut(); this.fire("zoom_out", { zoom_level: this._timenav.options.scale_factor }, this); } _onTimeNavLoaded() { this._loaded.timenav = true; this._onLoaded(); } _onStorySliderLoaded() { this._loaded.storyslider = true; this._onLoaded(); } _onStorySliderNext(e) { this.fire("nav_next", e); } _onStorySliderPrevious(e) { this.fire("nav_previous", e); } _updateDisplay(timenav_height, animate, d) { var duration = this.options.duration, display_class = this.options.base_class, menu_position = 0, self = this; if (d) { duration = d; } // Update width and height this.options.width = this._el.container.offsetWidth; this.options.height = this._el.container.offsetHeight; // Check if skinny if (this.options.width <= this.options.skinny_size) { display_class += " tl-skinny"; this.options.layout = "portrait"; } else if (this.options.width <= this.options.medium_size) { display_class += " tl-medium"; this.options.layout = "landscape"; } else { this.options.layout = "landscape"; } // Detect Mobile and Update Orientation on Touch devices if (Browser.touch) { this.options.layout = Browser.orientation(); } if (Browser.mobile) { display_class += " tl-mobile"; // Set TimeNav Height this.options.timenav_height = this._calculateTimeNavHeight(timenav_height, this.options.timenav_mobile_height_percentage); } else { // Set TimeNav Height this.options.timenav_height = this._calculateTimeNavHeight(timenav_height); } // LAYOUT if (this.options.layout == "portrait") { // Portrait display_class += " tl-layout-portrait"; } else { // Landscape display_class += " tl-layout-landscape"; } // Set StorySlider Height this.options.storyslider_height = (this.options.height - this.options.timenav_height); // Positon Menu if (this.options.timenav_position == "top") { menu_position = (Math.ceil(this.options.timenav_height) / 2) - (this._el.menubar.offsetHeight / 2) - (39 / 2); } else { menu_position = Math.round(this.options.storyslider_height + 1 + (Math.ceil(this.options.timenav_height) / 2) - (this._el.menubar.offsetHeight / 2) - (35 / 2)); } if (animate) { this._el.timenav.style.height = Math.ceil(this.options.timenav_height) + "px"; // Animate StorySlider if (this.animator_storyslider) { this.animator_storyslider.stop(); } this.animator_storyslider = Animate(this._el.storyslider, { height: this.options.storyslider_height + "px", duration: duration / 2, easing: easeOutStrong }); // Animate Menubar if (this.animator_menubar) { this.animator_menubar.stop(); } this.animator_menubar = Animate(this._el.menubar, { top: menu_position + "px", duration: duration / 2, easing: easeOutStrong }); } else { // TimeNav this._el.timenav.style.height = Math.ceil(this.options.timenav_height) + "px"; // StorySlider this._el.storyslider.style.height = this.options.storyslider_height + "px"; // Menubar this._el.menubar.style.top = menu_position + "px"; } if (this.message) { this.message.updateDisplay(this.options.width, this.options.height); } // Update Component Displays this._timenav.updateDisplay(this.options.width, this.options.timenav_height, animate); this._storyslider.updateDisplay(this.options.width, this.options.storyslider_height, animate, this.options.layout); if (this.language.direction == 'rtl') { display_class += ' tl-rtl'; } // Apply class this._el.container.className = display_class; } /** * Compute the height of the navigation section of the Timeline, taking * into account the possibility of an explicit height or height * percentage, but also honoring the `timenav_height_min` option * value. If `timenav_height` is specified it takes precedence over * `timenav_height_percentage` but in either case, if the resultant * pixel height is less than `options.timenav_height_min` then the * value of `options.timenav_height_min` will be returned. (A minor * adjustment is made to the returned value to account for marker * padding.) * * @param {number} [timenav_height] - an integer value for the desired height in pixels * @param {number} [timenav_height_percentage] - an integer between 1 and 100 */ _calculateTimeNavHeight(timenav_height, timenav_height_percentage) { var height = 0; if (timenav_height) { height = timenav_height; } else { if (this.options.timenav_height_percentage || timenav_height_percentage) { if (timenav_height_percentage) { height = Math.round((this.options.height / 100) * timenav_height_percentage); } else { height = Math.round((this.options.height / 100) * this.options.timenav_height_percentage); } } } // Set new minimum based on how many rows needed if (this._timenav.ready) { if (this.options.timenav_height_min < this._timenav.getMinimumHeight()) { this.options.timenav_height_min = this._timenav.getMinimumHeight(); } } // If height is less than minimum set it to minimum if (height < this.options.timenav_height_min) { height = this.options.timenav_height_min; } height = height - (this.options.marker_padding * 2); return height; } _validateOptions() { // assumes that this.options and this.config have been set. var INTEGER_PROPERTIES = ['timenav_height', 'timenav_height_min', 'marker_height_min', 'marker_width_min', 'marker_padding', 'start_at_slide', 'slide_padding_lr']; for (var i = 0; i < INTEGER_PROPERTIES.length; i++) { var opt = INTEGER_PROPERTIES[i]; var value = this.options[opt]; let valid = true; if (typeof(value) == 'number') { valid = (value == parseInt(value)) } else if (typeof(value) == "string") { valid = (value.match(/^\s*(\-?\d+)?\s*$/)); } if (!valid) { this.config.logError({ message_key: 'invalid_integer_option', detail: opt }); } } } /** * Given a slide identifier, return the zero-based positional index of * that slide. If this timeline has a 'title' slide, it is at position 0 * and all other slides are numbered after that. If there is no 'title' * slide, then the first event slide is at position 0. * @param {String} id */ _getSlideIndex(id) { if (this.config) { if (this.config.title && this.config.title.unique_id == id) { return 0; } for (var i = 0; i < this.config.events.length; i++) { if (id == this.config.events[i].unique_id) { return this.config.title ? i + 1 : i; } } } return -1; } /** * Given a slide identifier, return the zero-based positional index of that slide. * Does not take the existence of a 'title' slide into account, so if there is a title * slide, this value should be one less than calling `_getSlideIndex` with the same * identifier. If there is no title slide, `_getSlideIndex` and `_getEventIndex` * should return the same value. * TODO: does it really make sense to have both `_getSlideIndex` and `_getEventIndex`? * @param {String} id */ _getEventIndex(id) { for (var i = 0; i < this.config.events.length; i++) { if (id == this.config.events[i].unique_id) { return i; } } return -1; } _onLoaded() { if (this._loaded.storyslider && this._loaded.timenav) { this.fire("loaded", this.config); // Go to proper slide if (isTrue(this.options.start_at_end) || this.options.start_at_slide > this.config.events.length) { this.goToEnd(); } else { this.goTo(this.options.start_at_slide); } if (this.options.hash_bookmark) { if (window.location.hash != "") { this.goToId(window.location.hash.replace("#event-", "")); } else { this._updateHashBookmark(this.current_id); } let the_timeline = this; window.addEventListener('hashchange', function() { if (window.location.hash.indexOf('#event-') == 0) { the_timeline.goToId(window.location.hash.replace("#event-", "")); } }, false); } } } // Update hashbookmark in the url bar _updateHashBookmark(id) { if (id) { // TODO: validate the id... var hash = "#" + "event-" + id.toString(); window.history.replaceState(null, "Browsing TimelineJS", hash); this.fire("hash_updated", { unique_id: this.current_id, hashbookmark: "#" + "event-" + id.toString() }, this); } } /* PUBLIC API This has been minimally tested since most people use TimelineJS as an embed. If we hear from people who are trying to use TimelineJS this way, we will do what we can to make sure it works correctly, and will appreciate help! */ zoomIn() { this._timenav.zoomIn(); } zoomOut() { this._timenav.zoomOut(); } setZoom(level) { this._timenav.setZoom(level); } // Goto slide with id goToId(id) { if (this.current_id != id) { this.current_id = id; this._timenav.goToId(this.current_id); this._storyslider.goToId(this.current_id, false, true); this.fire("change", { unique_id: this.current_id }, this); } } // Goto slide n goTo(n) { if (n < 0) { return; } try { if (this.config.title) { if (n === 0) { this.goToId(this.config.title.unique_id); } else { this.goToId(this.config.events[n - 1].unique_id); } } else { this.goToId(this.config.events[n].unique_id); } } catch { // because n is interpreted differently depending on // whether there's a title slide, easier to use catch // to handle navigating beyond end instead of test before return } } // Goto first slide goToStart() { this.goTo(0); } // Goto last slide goToEnd() { var _n = this.config.events.length - 1; this.goTo(this.config.title ? _n + 1 : _n); } // Goto previous slide goToPrev() { this.goTo(this._getSlideIndex(this.current_id) - 1); this.focusContainer(); } // Goto next slide goToNext() { this.goTo(this._getSlideIndex(this.current_id) + 1); this.focusContainer(); } /* Event manipulation ================================================== */ // Add an event add(data) { var unique_id = this.config.addEvent(data); var n = this._getEventIndex(unique_id); var d = this.config.events[n]; this._storyslider.createSlide(d, this.config.title ? n + 1 : n); this._storyslider._updateDrawSlides(); this._timenav.createMarker(d, n); this._timenav._updateDrawTimeline(false); this.fire("added", { unique_id: unique_id }); } // Remove an event remove(n) { if (n >= 0 && n < this.config.events.length) { // If removing the current, nav to new one first if (this.config.events[n].unique_id == this.current_id) { if (n < this.config.events.length - 1) { this.goTo(n + 1); } else { this.goTo(n - 1); } } var event = this.config.events.splice(n, 1); delete this.config.event_dict[event[0].unique_id]; this._storyslider.destroySlide(this.config.title ? n + 1 : n); this._storyslider._updateDrawSlides(); this._timenav.destroyMarker(n); this._timenav._updateDrawTimeline(false); this.fire("removed", { unique_id: event[0].unique_id }); } } removeId(id) { this.remove(this._getEventIndex(id)); } /* Get slide data ================================================== */ getData(n) { if (this.config.title) { if (n == 0) { return this.config.title; } else if (n > 0 && n <= this.config.events.length) { return this.config.events[n - 1]; } } else if (n >= 0 && n < this.config.events.length) { return this.config.events[n]; } return null; } getDataById(id) { return this.getData(this._getSlideIndex(id)); } /* Get slide object ================================================== */ getSlide(n) { if (n >= 0 && n < this._storyslider._slides.length) { return this._storyslider._slides[n]; } return null; } getSlideById(id) { return this.getSlide(this._getSlideIndex(id)); } getCurrentSlide() { return this.getSlideById(this.current_id); } updateDisplay() { if (this.ready) { this._updateDisplay(); } else { trace('updateDisplay called but timeline is not in ready state') } } focusContainer() { this._el.container.focus(); } _initGoogleAnalytics(measurement_id) { loadJS(`https://www.googletagmanager.com/gtag/js?id=${measurement_id}`) window.dataLayer = window.dataLayer || []; window.gtag = function(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', measurement_id); } _initAnalytics() { let measurement_id = this.options.ga_measurement_id || this.options.ga_property_id || null; if (!measurement_id) { return; } this._initGoogleAnalytics(measurement_id); var events = this.options.track_events; for (let i = 0; i < events.length; i++) { var event_ = events[i]; this.addEventListener(event_, function(e) { gtag('event', e.type); }); } } } classMixin(Timeline, I18NMixins, Events) export { Timeline }