carbon-components/src/globals/js/boot.js

Carbon Components is a component library for IBM Cloud

import settings from './settings';
import * as defaultComponents from './components';

let components = defaultComponents;

/**
 * The handles for event handlers to lazily instantiate components.
 * @type {Handle[]}
 */
const lazyInitHandles = [];

/**
 * Instantiates components automatically
 * by searching for elements with `data-component-name` (e.g. `data-loading`) attribute
 * or upon DOM events (e.g. clicking) on such elements.
 * See each components' static `.init()` methods for details.
 * @private
 */
const init = () => {
  const componentClasses = Object.keys(components)
    .map(key => components[key])
    .filter(component => typeof component.init === 'function');
  if (!settings.disableAutoInit) {
    componentClasses.forEach(Clz => {
      const h = Clz.init();
      if (h) {
        lazyInitHandles.push(h);
      }
    });
  }
};

/**
 * Replaces the list of components to initialize.
 * @param {Object} componentsToReplaceWith The new list of components.
 */
export const setComponents = componentsToReplaceWith => {
  components = componentsToReplaceWith;
};

if (document.readyState === 'loading') {
  document.addEventListener('DOMContentLoaded', init);
} else {
  // DOMContentLoaded has been fired already
  // Let consumer have chance to see if it wants automatic instantiation disabled, and then run automatic instantiation otherwise
  setTimeout(init, 0);
}

export default lazyInitHandles;