@lumjs/dom NPM

lum.dom.js

A small set of DOM helpers wrapped in a minimalist core.

Features

Wraps a window object so it works in browser or Node.js with jsdom.
Has a bunch of simple type tests.
Simple method wrappers for common functionality:
- dom.elem() → document.createElement()
- dom.frag() → document.createDocumentFragment()
- dom.parse() → (new DOMParser()).parseFromString()
- dom.html() → Use dom.parse() forcing HTML, and return the element(s). Can optionally run dom.extend() on the returned value automatically.
- dom.xml() → Use dom.parse() forcing XML, and return the document element. Can optionally run dom.extend() automatically.
A Query library which extends querySelector and querySelectorAll.
- Use dom.query for access to a default library instance.
- Has a dom.find() shortcut method to find multiple nodes. Can optionally return an HTMLCollection instead of a NodeList.
- Has a dom.get() shortcut method to find a single node.
- With dom.options.extendQueries set to true, results from either of the shortcut methods use dom.extend() automatically.
An Events library to make working with event handlers easier.
- Supports building delegated event handlers automatically.
- Use dom.events for access to a default library instance.
- Has dom.on(), dom.off(), dom.trigger() shortcut methods.
An Extender library to add additional methods and accessor properties to Node, NodeList, or HTMLCollection object instances.
- Use dom.extender for access to a default library instance.
- Has a dom.extend() shortcut method.
A ListCompiler library for building NodeList and HTMLCollection objects, which normally cannot be constructed manually.
- Use dom.listCompiler for access to a default library instance.
- Used by the Query library to build composite lists, and to convert NodeList results into HTMLCollection results when asked to.
- Can be easily extended to add other DOM objects without constructors.