diva.js 6.0.1 → 7.2.3

package/source/js/utils/elt.js

@@ -1,94 +0,0 @@
-export { setDOMAttributes as setAttributes };
-
-/**
- * Convenience function to create a DOM element, set attributes on it, and
- * append children. All arguments which are not of primitive type, are not
- * arrays, and are not DOM nodes are treated as attribute hashes and are
- * handled as described for setDOMAttributes. Children can either be a DOM
- * node or a primitive value, which is converted to a text node. Arrays are
- * handled recursively. Null and undefined values are ignored.
- *
- * Inspired by the ProseMirror helper of the same name.
- */
-export function elt (tag)
-{
-    const el = document.createElement(tag);
-    const args = Array.prototype.slice.call(arguments, 1);
-
-    while (args.length)
-    {
-        const arg = args.shift();
-        handleEltConstructorArg(el, arg);
-    }
-
-    return el;
-}
-
-function handleEltConstructorArg (el, arg)
-{
-    if (arg == null)  // NB: == is correct;
-        return;
-
-    if (typeof arg !== 'object' && typeof arg !== 'function')
-    {
-        // Coerce to string
-        el.appendChild(document.createTextNode(arg));
-    }
-    else if (arg instanceof window.Node)
-    {
-        el.appendChild(arg);
-    }
-    else if (arg instanceof Array)
-    {
-        const childCount = arg.length;
-        for (let i = 0; i < childCount; i++)
-            handleEltConstructorArg(el, arg[i]);
-    }
-    else
-    {
-        setDOMAttributes(el, arg);
-    }
-}
-
-/**
- * Set attributes of a DOM element. The `style` property is special-cased to
- * accept either a string or an object whose own attributes are assigned to
- * el.style.
- */
-function setDOMAttributes (el, attributes)
-{
-    for (const prop in attributes)
-    {
-        if (!attributes.hasOwnProperty(prop))
-            continue;
-
-        if (prop === 'style')
-        {
-            setStyle(el, attributes.style);
-        }
-        else
-        {
-            el.setAttribute(prop, attributes[prop]);
-        }
-    }
-}
-
-function setStyle (el, style)
-{
-    if (!style)
-        return;
-
-    if (typeof style !== 'object')
-    {
-        el.style.cssText = style;
-        return;
-    }
-
-    for (const cssProp in style)
-    {
-        if (!style.hasOwnProperty(cssProp))
-            continue;
-
-        el.style[cssProp] = style[cssProp];
-    }
-}

package/source/js/utils/events.js

@@ -1,190 +0,0 @@
-/**
- * Events. Pub/Sub system for Loosely Coupled logic.
- * Based on Peter Higgins' port from Dojo to jQuery
- * https://github.com/phiggins42/bloody-jquery-plugins/blob/master/pubsub.js
- *
- * Re-adapted to vanilla Javascript
- *
- * @class Events
- */
-
-class DivaEvents
-{
-    constructor()
-    {
-        this._cache = {};
-    }
-
-    /**
-     * diva.Events.publish
-     * e.g.: diva.Events.publish("PageDidLoad", [pageIndex, filename, pageSelector], this);
-     *
-     * @class Events
-     * @method publish
-     * @param topic {String}
-     * @param args  {Array}
-     * @param scope {Object=} Optional - Subscribed functions will be executed with the supplied object as `this`.
-     *     It is necessary to supply this argument with the self variable when within a Diva instance.
-     *     The scope argument is matched with the instance ID of subscribers to determine whether they
-     *         should be executed. (See instanceID argument of subscribe.)
-     */
-    publish(topic, args, scope)
-    {
-        if (this._cache[topic])
-        {
-            const thisTopic = this._cache[topic];
-
-            if (typeof thisTopic.global !== 'undefined')
-            {
-                const thisTopicGlobal = thisTopic.global;
-                const globalCount = thisTopicGlobal.length;
-
-                for (let i=0; i < globalCount; i++)
-                {
-                    thisTopicGlobal[i].apply(scope || null, args || []);
-                }
-            }
-
-            if (scope && typeof scope.getInstanceId !== 'undefined')
-            {
-                // get publisher instance ID from scope arg, compare, and execute if match
-                const instanceID = scope.getInstanceId();
-
-                if (this._cache[topic][instanceID])
-                {
-                    const thisTopicInstance = this._cache[topic][instanceID];
-                    const scopedCount = thisTopicInstance.length;
-
-                    for (let j=0; j < scopedCount; j++)
-                    {
-                        thisTopicInstance[j].apply(scope, args || []);
-                    }
-                }
-            }
-        }
-    }
-
-    /**
-     * diva.Events.subscribe
-     * e.g.: diva.Events.subscribe("PageDidLoad", highlight, settings.ID)
-     *
-     * @class Events
-     * @method subscribe
-     * @param {string} topic
-     * @param {function} callback
-     * @param {string=} instanceID  Optional - String representing the ID of a Diva instance; if provided,
-     *                                       callback only fires for events published from that instance.
-     * @return Event handler {Array}
-     */
-    subscribe(topic, callback, instanceID)
-    {
-        if (!this._cache[topic])
-        {
-            this._cache[topic] = {};
-        }
-
-        if (typeof instanceID === 'string')
-        {
-            if (!this._cache[topic][instanceID])
-            {
-                this._cache[topic][instanceID] = [];
-            }
-
-            this._cache[topic][instanceID].push(callback);
-        }
-        else
-        {
-            if (!this._cache[topic].global)
-            {
-                this._cache[topic].global = [];
-            }
-
-            this._cache[topic].global.push(callback);
-        }
-
-        return instanceID ? [topic, callback, instanceID] : [topic, callback];
-    }
-
-    /**
-     * diva.Events.unsubscribe
-     * e.g.: var handle = Events.subscribe("PageDidLoad", highlight);
-     *         Events.unsubscribe(handle);
-     *
-     * @class Events
-     * @method unsubscribe
-     * @param {array} handle
-     * @param {boolean=} completely - Unsubscribe all events for a given topic.
-     * @return {boolean} success
-     */
-    unsubscribe(handle, completely)
-    {
-        const t = handle[0];
-
-        if (this._cache[t])
-        {
-            let topicArray;
-            const instanceID = handle.length === 3 ? handle[2] : 'global';
-
-            topicArray = this._cache[t][instanceID];
-
-            if (!topicArray)
-            {
-                return false;
-            }
-
-            if (completely)
-            {
-                delete this._cache[t][instanceID];
-                return topicArray.length > 0;
-            }
-
-            let i = topicArray.length;
-
-            while (i--)
-            {
-                if (topicArray[i] === handle[1])
-                {
-                    this._cache[t][instanceID].splice(i, 1);
-                    return true;
-                }
-            }
-        }
-
-        return false;
-    }
-
-    /**
-     * diva.Events.unsubscribeAll
-     * e.g.: diva.Events.unsubscribeAll('global');
-     *
-     * @class Events
-     * @param {string=} instanceID Optional - instance ID to remove subscribers from or 'global' (if omitted,
-     *                              subscribers in all scopes removed)
-     * @method unsubscribeAll
-     */
-    unsubscribeAll(instanceID)
-    {
-        if (instanceID)
-        {
-            const topics = Object.keys(this._cache);
-            let i = topics.length;
-            let topic;
-
-            while (i--)
-            {
-                topic = topics[i];
-
-                if (typeof this._cache[topic][instanceID] !== 'undefined')
-                {
-                    delete this._cache[topic][instanceID];
-                }
-            }
-        }
-        else
-        {
-            this._cache = {};
-        }
-    }
-}
-
-export let Events = new DivaEvents();

package/source/js/utils/get-scrollbar-width.js

@@ -1,29 +0,0 @@
-// From http://www.alexandre-gomes.com/?p=115, modified slightly
-export default function getScrollbarWidth()
-{
-    let inner = document.createElement('p');
-    inner.style.width = '100%';
-    inner.style.height = '200px';
-
-    let outer = document.createElement('div');
-    outer.style.position = 'absolute';
-    outer.style.top = '0px';
-    outer.style.left = '0px';
-    outer.style.visibility = 'hidden';
-    outer.style.width = '200px';
-    outer.style.height = '150px';
-    outer.style.overflow = 'hidden';
-    outer.appendChild(inner);
-
-    document.body.appendChild(outer);
-
-    let w1 = inner.offsetWidth;
-    outer.style.overflow = 'scroll';
-    let w2 = inner.offsetWidth;
-    if (w1 === w2) {
-        w2 = outer.clientWidth; // for IE i think
-    }
-
-    document.body.removeChild(outer);
-    return w1 - w2;
-}

package/source/js/utils/hash-params.js

@@ -1,86 +0,0 @@
-let HashParams = {
-    get: getHashParam,
-    update: updateHashParam
-};
-
-export default HashParams;
-
-
-// For getting the #key values from the URL. For specifying a page and zoom level
-// Look into caching, because we only need to get this during the initial load
-// Although for the tests I guess we would need to override caching somehow
-function getHashParam (key)
-{
-    const hash = window.location.hash;
-
-    if (hash !== '')
-    {
-        // Check if there is something that looks like either &key= or #key=
-        let startIndex = (hash.indexOf('&' + key + '=') > 0) ? hash.indexOf('&' + key + '=') : hash.indexOf('#' + key + '=');
-
-        // If startIndex is still -1, it means it can't find either
-        if (startIndex >= 0)
-        {
-            // Add the length of the key plus the & and =
-            startIndex += key.length + 2;
-
-            // Either to the next ampersand or to the end of the string
-            const endIndex = hash.indexOf('&', startIndex);
-            if (endIndex > startIndex)
-            {
-                return decodeURIComponent(hash.substring(startIndex, endIndex));
-            }
-            else if (endIndex < 0)
-            {
-                // This means this hash param is the last one
-                return decodeURIComponent(hash.substring(startIndex));
-            }
-            // If the key doesn't have a value I think
-            return '';
-        }
-        else
-        {
-            // If it can't find the key
-            return false;
-        }
-    }
-    else
-    {
-        // If there are no hash params just return false
-        return false;
-    }
-}
-
-function updateHashParam (key, value)
-{
-    // First make sure that we have to do any work at all
-    const originalValue = getHashParam(key);
-    const hash = window.location.hash;
-
-    if (originalValue !== value)
-    {
-        // Is the key already in the URL?
-        if (typeof originalValue === 'string')
-        {
-            // Already in the URL. Just get rid of the original value
-            const startIndex = (hash.indexOf('&' + key + '=') > 0) ? hash.indexOf('&' + key + '=') : hash.indexOf('#' + key + '=');
-            const endIndex = startIndex + key.length + 2 + originalValue.length;
-            // # if it's the first, & otherwise
-            const startThing = (startIndex === 0) ? '#' : '&';
-            window.location.replace(hash.substring(0, startIndex) + startThing + key + '=' + value + hash.substring(endIndex));
-        }
-        else
-        {
-            // It's not present - add it
-            if (hash.length === 0)
-            {
-                window.location.replace('#' + key + '=' + value);
-            }
-            else
-            {
-                // Append it
-                window.location.replace(hash + '&' + key + '=' + value);
-            }
-        }
-    }
-}

package/source/js/utils/parse-label-value.js

@@ -1,34 +0,0 @@
-/**
- * Parses a v3 manifest's label/value pair from an object & array to a string
- *
- * @public
- * @params {string} key - The key from which a label/value pair should be extracted.
- * @returns {object} - The label/value pair as strings.
- * */
-
-export default function parseLabelValue (key)
-{
-    let l = key.label; 
-    let label = (typeof l === 'object') ? l[Object.keys(l)[0]][0] : l;
-
-    let v = key.value;
-    let value;
-    if (Array.isArray(v))
-    { // is array of objects
-        value = v.map(e => e[Object.keys(e)[0]]);
-    }
-    else
-    { // is object where value is possibly an array
-        value = (typeof v === 'object') ? v[Object.keys(v)[0]] : v;
-    }
-
-    if (Array.isArray(value))
-    {
-        value = value.join(', ');
-    }
-
-    return {
-        label: label,
-        value: value
-    };
-}