`up.element`

JavaScript namespace

Low-level functions to access and change the DOM.

up.element.get() and up.element.subtree() look up elements. up.element.createFromHTML() and up.element.createFromSelector() build elements, and up.element.affix() builds one and attaches it to a parent. Functions like up.element.attr(), up.element.numberAttr() and up.element.jsonAttr() parse attribute values into typed values, and up.element.toggle() or up.element.hide() change visibility through the [hidden] attribute.

These functions know nothing about layers or animation. For a fragment-aware API, prefer up.fragment.

Features

[hidden] ATTR experimental

Elements with this attribute are hidden from the page.
up.element.affix(parent, [position], selector, [attrs]) JS

Creates an element matching the given CSS selector and attaches it to the given parent element.
up.element.all([parent], selector) JS deprecated

Returns all descendant elements matching the given selector.
up.element.attr(element, attribute) JS

Returns the given attribute value for the given element.
up.element.booleanAttr(element, attribute) JS

Returns the value of the given attribute on the given element, cast as a boolean value.
up.element.closest(element, selector) JS deprecated

Returns the first element that matches the selector by testing the element itself and traversing up through its ancestors in the DOM tree.
up.element.createFromHTML(html) JS

Parses an element from the given HTML fragment string.
up.element.createFromSelector(selector, [attrs]) JS

Creates an element matching the given CSS selector.
up.element.createNodesFromHTML(html) JS experimental

Parses a list of nodes from a string of HTML.
up.element.first([parent], selector) JS deprecated

Returns the first descendant element matching the given selector.
up.element.get([parent], value) JS

Returns the native Element for the given value.
up.element.hide(element) JS

Hides the given element.
up.element.isAttached(element) JS deprecated

Returns whether the given element is attached to the DOM tree.
up.element.isDetached(element) JS deprecated

Returns whether the given element has been removed from the DOM tree.
up.element.isEmpty(element) JS experimental

Returns whether the given element has no content.
up.element.isVisible(element) JS

Returns whether the given element is currently visible.
up.element.jsonAttr(element, attribute) JS

Reads the given attribute from the element, parsed as relaxed JSON.
up.element.matches(element, selector) JS deprecated

Returns whether the given element matches the given CSS selector.
up.element.numberAttr(element, attribute) JS

Returns the value of the given attribute on the given element, cast to a number.
up.element.remove(element) JS deprecated

Removes the given element from the DOM tree.
up.element.replace(oldElement, newElement) JS deprecated

Replaces the given old element with the given new element.
up.element.setAttrs(element, attributes) JS

Sets properties from the given object as attributes on the given element.
up.element.setStyle(element, styles) JS

Sets the given CSS properties as inline styles on the given element.
up.element.show(element) JS

Shows the given element.
up.element.style(element, propOrProps) JS

Returns computed CSS styles for the given element.
up.element.styleNumber(element, prop) JS

Returns a computed CSS property value for the given element, cast as a number.
up.element.subtree(root, selector) JS

Returns a list of a root element's descendants matching the given selector.
up.element.toggle(element, [newVisible]) JS

Changes whether the given element is shown or hidden.
up.element.toggleClass(element, className, [newPresent]) JS deprecated

Adds or removes the given class from the given element.
up.element.toSelector(element) JS deprecated

Returns a CSS selector that matches the given element as good as possible.