live-photos.js

  1. var LivePhoto = require('./live-photo');
  2. var styles = require('./styles.scss');
  4. var supportsLivePhotos = true;
  5. var stylesInUse = 0;
  6. var useStyles = true;
  8. /**
  9.  * Initializes the Live Photos on a page specified by the `data-live-photo` attribute or supplied
  10.  *
  11.  * @memberof LivePhotos
  12.  * @static
  13.  * @alias initialize
  14.  *
  15.  * @param  {Object|Array|string} [elements] - elements or selectors to create Live Photos from
  16.  * @param  {Object} [options] - options passed to each live photo
  17.  *
  18.  * @return {Array<LivePhoto>} Array of {@link LivePhoto} instances
  19.  */
  20. function initializeLivePhotos(elements, options) {
  21.     if (!supportsLivePhotos) {
  22.         return;
  23.     }
  25.     if (useStyles) {
  26.         addStyles();
  27.     }
  29.     if (typeof elements === 'object' && elements.toString() === '[object Object]') {
  30.         options = elements;
  31.         elements = options.elements;
  32.         delete options.elements;
  33.     }
  35.     elements || (elements = 'img[data-live-photo]');
  37.     if (typeof elements === 'string') {
  38.         elements = document.querySelectorAll(elements);
  39.     }
  41.     if (elements instanceof HTMLElement) {
  42.         elements = [elements];
  43.     }
  45.     var livePhotos = [];
  46.     Array.prototype.forEach.call(elements, function(el) {
  47.         if (typeof el === 'string') {
  48.             el = document.querySelector(el);
  49.         }
  51.         if (el) {
  52.             var livePhoto = new LivePhoto(el, options);
  53.             livePhotos.push(livePhoto);
  54.         }
  55.     });
  57.     return livePhotos;
  58. }
  60. /**
  61.  * Appends the styles to the page
  62.  *
  63.  * @memberof LivePhotos
  64.  * @static
  65.  */
  66. function addStyles() {
  67.     styles.use();
  68.     stylesInUse++;
  69. }
  71. /**
  72.  * Prevents styles from being appended to the page
  73.  *
  74.  * @memberof LivePhotos
  75.  * @static
  76.  */
  77. function noStyles() {
  78.     useStyles = false;
  79. }
  81. /**
  82.  * Removes appended styles
  83.  *
  84.  * @memberof LivePhotos
  85.  * @static
  86.  */
  87. function cleanup() {
  88.     while (stylesInUse > 0) {
  89.         styles.unuse();
  90.         stylesInUse--;
  91.     }
  92. }
  94. /**
  95.  * By default, this module acts as a function that creates LivePhotos, but using the
  96.  * {@linkplain LivePhotos.initialize static method} is preferable.
  97.  *
  98.  * @namespace LivePhotos
  99.  * @see {@link LivePhotos.initialize}
  100.  */
  101. function LivePhotos(elements, options) {
  102.     return initializeLivePhotos(elements, options);
  103. }
  105. LivePhotos.initialize = initializeLivePhotos;
  106. LivePhotos.addStyles = addStyles;
  107. LivePhotos.noStyles = noStyles;
  108. LivePhotos.cleanup = cleanup;
  110. /**
  111.  * Passthrough for the {@link LivePhoto} class
  112.  *
  113.  * @memberof LivePhotos
  114.  * @see {@link LivePhoto}
  115.  */
  116. LivePhotos.LivePhoto = LivePhoto;
  118. module.exports = LivePhotos;