vanillajs-browser-helpers/src/prepend.ts

Collection of convenience code snippets (helpers) that aims to make it a little easier to work with vanilla JS in the browser

import isString from 'vanillajs-helpers/isString';

import ensureHTML from './ensureHTML';



/**
 * Append DOM element or plain HTML to the beginning of a given DOM element
 *
 * @param elm - The DOM element to append to
 * @param insertElm - DOM element or HTML (or selector) to append to insert
 * @return The inserted child element
 */
export default function prepend(elm: Element, insertElm: string | Node): Element | null {
  if (!elm) { return null; }

  if (isString(insertElm)) {
    elm.insertAdjacentHTML('afterbegin', ensureHTML(insertElm));
  } else {
    elm.prepend(insertElm);
  }

  return elm.firstElementChild;
}