Element

Create a new, standalone Element. (Standalone in that is has no parent.)

Create a new Element from a tag and a base URI.

Add a class name to this element's class attribute.

Insert the specified HTML into the DOM after this element (i.e. as a following sibling).

Add inner HTML to this element. The supplied HTML will be parsed, and each node appended to the end of the children.

Add a node to the last child of this element.

Create a new element by tag name, and add it as the last child.

Create and append a new TextNode to this element.

Set an attribute value on this element. If this element already has an attribute with the key, its value is updated; otherwise, a new attribute is added.

Insert the specified HTML into the DOM before this element (i.e. as a preceeding sibling).

Get a child element of this element, by its 0-based index number.

Note that an element can have both mixed Nodes and Elements as children. This method inspects a filtered list of children that are elements, and the index is based on that filtered list.

Get this element's child elements.

This is effectively a filter on childNodes() to get Element nodes.

Gets the literal value of this element's "class" attribute, which may include multiple class names, space separated. (E.g. on <div class="header gray"> returns, "header gray")

Get all of the element's class names. E.g. on element <div class="header gray">}, returns a set of two elements "header", "gray". Note that modifications to this set are not pushed to the backing class attribute; use the classNames(java.util.Set) method to persist them.

Set the element's class attribute to the supplied class names.

Create a stand-alone, deep copy of this node, and all of its children. The cloned node will have no siblings or parent node. As a stand-alone object, any changes made to the clone or any of its children will not impact the original node.

The cloned node may be adopted into another Document or node structure using appendChild(Node).

Get the combined data of this element. Data is e.g. the inside of a script tag.

Get this element's HTML5 custom data attributes. Each attribute in the element that has a key starting with "data-" is included the dataset.

E.g., the element <div data-package="jsoup" data-language="Java" class="group">... has the dataset package=jsoup, language=java.

This map is a filtered view of the element's attribute map. Changes to one map (add, remove, update) are reflected in the other map.

You can find elements that have data attributes using the [^data-] attribute key prefix selector.

Get the list index of this element in its element sibling list. I.e. if this is the first element sibling, returns 0.

Remove all of the element's child nodes. Any attributes are left as-is.

Gets the first element sibling of this element.

Find all elements under this element (including self, and children of children).

Find an element by ID, including or under this element.

Note that this finds the first matching ID, starting with this element. If you search down from a different starting point, it is possible to find a different element by ID. For unique element by ID within a Document, use getElementById(String)

Find elements that have a named attribute set. Case insensitive.

Find elements that have an attribute name starting with the supplied prefix. Use data- to find elements that have HTML5 datasets.

Find elements that have an attribute with the specific value. Case insensitive.

Find elements that have attributes whose value contains the match string. Case insensitive.

Find elements that have attributes that end with the value suffix. Case insensitive.

Find elements that have attributes whose values match the supplied regular expression.

Find elements that have attributes whose values match the supplied regular expression.

Find elements that either do not have this attribute, or have it with a different value. Case insensitive.

Find elements that have attributes that start with the value prefix. Case insensitive.

Find elements that have this class, including or under this element. Case insensitive.

Elements can have multiple classes (e.g. <div class="header round first">. This method checks each class, so you can find the above with el.getElementsByClass("header");.

Find elements whose sibling index is equal to the supplied index.

Find elements whose sibling index is greater than the supplied index.

Find elements whose sibling index is less than the supplied index.

Finds elements, including and recursively under this element, with the specified tag name.

Find elements that directly contain the specified string. The search is case insensitive. The text must appear directly in the element, not in any of its descendants.

Find elements that contain the specified string. The search is case insensitive. The text may appear directly in the element, or in any of its descendants.

Find elements whose own text matches the supplied regular expression.

Find elements whose text matches the supplied regular expression.

Find elements whose text matches the supplied regular expression.

Find elements whose text matches the supplied regular expression.

Tests if this element has a class. Case insensitive.

Test if this element has any text content (that is not just whitespace).

Retrieves the element's inner HTML. E.g. on a <div> with one empty <p>, would return <p></p>. (Whereas outerHtml() would return <div><p></p></div>.)

Set this element's inner HTML. Clears the existing HTML first.

Get the id attribute of this element.

Test if this element is a block-level element. (E.g. <div> == true or an inline element <p> == false).

Gets the last element sibling of this element

Gets the next sibling element of this element. E.g., if a div contains two ps, the nextElementSibling of the first p is the second p.

This is similar to nextSibling(), but specifically finds only Elements

Get the node name of this node. Use for debugging purposes and not logic switching (for that, use instanceof).

Gets the text owned by this element only; does not get the combined text of all children.

For example, given HTML <p>Hello <b>there</b> now!</p>, p.ownText() returns "Hello now!", whereas p.text() returns "Hello there now!". Note that the text within the b element is not returned, as it is not a direct child of the p element.

Gets this node's parent node.

Get this element's parent and ancestors, up to the document root.

Add inner HTML into this element. The supplied HTML will be parsed, and each node prepended to the start of the element's children.

Add a node to the start of this element's children.

Create a new element by tag name, and add it as the first child.

Create and prepend a new TextNode to this element.

Gets the previous element sibling of this element.

Remove a class name from this element's class attribute.

Find elements that match the Selector query, with this element as the starting context. Matched elements may include this element, or any of its children.

This method is generally more powerful to use than the DOM-type getElementBy* methods, because multiple filters can be combined, e.g.:

• el.select("a[href]") - finds links (a tags with href attributes)
• el.select("a[href*=example.com]") - finds links pointing to example.com (loosely)

See the query syntax documentation in Selector.

Get sibling elements.

Get the Tag for this element.

Change the tag of this element. For example, convert a <span> to a <div> with el.tagName("div");.

Get the name of the tag for this element. E.g. div

Gets the combined text of this element and all its children.

For example, given HTML <p>Hello <b>there</b> now!</p>, p.text() returns "Hello there now!"

Set the text of this element. Any existing contents (text or elements) will be cleared

Toggle a class name on this element's class attribute: if present, remove it; otherwise add it.

Get the value of a form element (input, textarea, etc).

Set the value of a form element (input, textarea, etc).

Wrap the supplied HTML around this element.