vanillajs-browser-helpers/src/create.ts

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

import selectorToHTML from './selectorToHTML';
import toDOM from './toDOM';



/**
 * Creates an element from a given CSS selector (restricted to only one element)
 *
 * @param selector - The CSS selector to convert
 * @return The created element
 *
 * @example
 *
 * ```ts
 * // Create a div
 * create();
 * // -> <div />
 *
 * // Create an element
 * create('img');
 * // -> <img />
 *
 * // Create an element from a selector
 * create(#MyElement.active);
 * // -> <div id="MyElement" class="active" />
 * ```
 */
export default function create(selector = 'div'): Element {
  return /^[a-z]+$/i.test(selector)
    ? document.createElement(selector)
    : (toDOM(selectorToHTML(selector)) as HTMLCollection)[0];
}



create();