@tempots/dom

DOMContext interface

DOMContext is an immutable class that represents the context of a DOM element. It provides methods and properties to manipulate and interact with the DOM element.

A reference in a DOMContext is to mark a position within a set of sibblings. It is used to insert new elements before the reference.

Signature:

export interface DOMContext

Methods

Method	Description
addClasses(tokens)	Adds classes to the element.
clear(removeTree)
getClasses()	Gets the classes of the element.
getProvider(mark)	Retrieves a provider for the given provider mark.
getStyle(name)	Gets the style of the element.
getText()	Gets the text content of the current element or text node.
isBrowserDOM()	Returns `true` if the context is a browser DOM context.
isHeadlessDOM()	Returns `true` if the context is a headless DOM context.
makeAccessors(name)	Returns an object with methods to get and set the value of a property or attribute.
makeChildElement(tagName, namespace)	Creates a new DOM element (eg: HTML or SVG) with the specified tag name and namespace and appends it to the current element.
makeChildText(text)	Creates a new text node with the specified text content and appends it to the current element.
makePortal(selector)	Creates a new `DOMContext` instance with a reference to a DOM element selected by the provided `selector`.
makeRef()	Creates a new `DOMContext` with a reference to a newly created text node. The text node is appended or inserted to the current `DOMContext`. The new `DOMContext` with the reference is returned.
on(event, listener, options)	Adds an event listener to the element.
removeClasses(tokens)	Removes classes from the element.
setStyle(name, value)	Sets the style of the element.
setText(text)	Sets the text content of the current element.
withProviders(providers)	Returns a new DOMContext instance with the specified providers merged into the existing providers.