API
DOM helpers
module
up.element
The up.element module offers functions for DOM manipulation and traversal.
It complements native Element methods and works across all supported browsers.
Differences to up.fragment
up.element is a low-level API to work with DOM elements directly. Unpoly also a higher-level API in up.fragment:
- By default
up.fragmentfunctions will only see elements from the current layer.up.elementis not aware of layers and always sees the entire DOM. -
up.fragmentfunctions will ignore elements that are being destroyed, but are still finishing an exit animation (e.g. fading out). - Functions in
up.fragmentsupport non-standard CSS extensions like:mainor:layer. Functions inup.elementonly understands the CSS selectors supported by the current browser.
Features
All features
HTMLElements with this attribute are hidden from the page.
Creates an element matching the given CSS selector and attaches it to the given parent element.
Returns all descendant elements matching the given selector.
Returns the given attribute value for the given element.
Returns the value of the given attribute on the given element, cast as a boolean value.
Returns the first element that matches the selector by testing the element itself and traversing up through its ancestors in the DOM tree.
Creates an element from the given HTML fragment string.
Creates an element matching the given CSS selector.
Returns the first descendant element matching the given selector.
Returns the native Element for the given value.
Hides the given element.
Returns whether the given element is attached to the DOM tree.
Returns whether the given element has been removed from the DOM tree.
Returns whether the given element has no content.
Returns whether the given element is currently visible.
Reads the given attribute from the element, parsed as JSON.
Returns whether the given element matches the given CSS selector.
Returns the value of the given attribute on the given element, cast to a number.
Removes the given element from the DOM tree.
Replaces the given old element with the given new element.
Sets all key/values from the given object as attributes on the given element.
Sets the given CSS properties as inline styles on the given element.
Shows the given element.
Receives computed CSS styles for the given element.
Receives a computed CSS property value for the given element, casted as a number.
Returns a list of the given parent's descendants matching the given selector. The list will also include the parent element if it matches the selector itself.
Changes whether the given element is shown or hidden.
Adds or removes the given class from the given element.
Returns a CSS selector that matches the given element as good as possible.