com.teamdev.jxbrowser.dom

Interface Element

All Superinterfaces:

EventTarget, Node, SearchContext

All Known Subinterfaces:

FormControlElement, FormElement, FrameElement, InputElement, OptionElement, SelectElement, TextAreaElement

public interface Element
extends Node

An HTML DOM element.

All HTML element interfaces derive from this interface.

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.lang.String>	attributes() Returns an immutable map that contains attributes of the element.
java.lang.String	attributeValue(java.lang.String attrName) Returns a string that represents the value of the attribute with the given attrName.
Rect	boundingClientRect() Returns a Rect object representing the bounds of the element and its position relative to the top-left of the viewport of the current document.
boolean	hasAttribute(java.lang.String attrName) Returns true when an attribute with the given attrName is specified on this element or has a default value, otherwise returns false.
java.lang.String	innerHtml() Returns a string that represents the HTML content of this element or an empty string if the element does not have the inner HTML.
boolean	innerHtml(java.lang.String html) Replaces the HTML content of this element with the given html.
java.lang.String	innerText() Returns a string that represents the text content of the element and its descendants.
boolean	innerText(java.lang.String innerText) Replaces the text content of the element with the given innerText value.
void	putAttribute(java.lang.String attrName, java.lang.String attrValue) Adds a new attribute to the element.
void	removeAttribute(java.lang.String attrName) Removes an element attribute specified by the given attrName.

Methods inherited from interface com.teamdev.jxbrowser.dom.Node

appendChild, children, click, evaluate, evaluate, insertChild, nextSibling, nodeName, nodeValue, nodeValue, parent, previousSibling, removeChild, replaceChild, textContent, textContent, type

Methods inherited from interface com.teamdev.jxbrowser.dom.event.EventTarget

addEventListener, dispatch, eventListeners, removeEventListener

Methods inherited from interface com.teamdev.jxbrowser.dom.SearchContext

findElementByClassName, findElementByCssSelector, findElementById, findElementByName, findElementByTagName, findElementsByClassName, findElementsByCssSelector, findElementsById, findElementsByName, findElementsByTagName

Method Detail

attributeValue

java.lang.String attributeValue(java.lang.String attrName)

Returns a string that represents the value of the attribute with the given attrName.

Parameters:

attrName - the attribute name

Returns:

a string that represents the value of an attribute with the given attrName or an empty string if the attribute with the given attrName does not exist

Throws:

java.lang.IllegalArgumentException - when attrName is empty or blank

java.lang.IllegalStateException - when the document this instance belongs to is closed

putAttribute

void putAttribute(java.lang.String attrName,
                  java.lang.String attrValue)

Adds a new attribute to the element. If an attribute with the given attrName is already defined in the element, its value will be replaced with the new one.

Parameters:

attrName - the name of the attribute to create or alter

attrValue - value to set in string form. Can be empty for boolean attribute names which are always true despite the attribute value

Throws:

java.lang.IllegalArgumentException - when attrName is empty or blank

java.lang.IllegalStateException - when the document this instance belongs to is closed

removeAttribute

void removeAttribute(java.lang.String attrName)

Removes an element attribute specified by the given attrName. This method does nothing if the element does not have the attrName attribute.

Parameters:

attrName - the name of the attribute to remove

Throws:

java.lang.IllegalArgumentException - when attrName is empty or blank

java.lang.IllegalStateException - when the document this instance belongs to is closed

hasAttribute

boolean hasAttribute(java.lang.String attrName)

Returns true when an attribute with the given attrName is specified on this element or has a default value, otherwise returns false.

Parameters:

attrName - the name of the attribute

Throws:

java.lang.IllegalArgumentException - when attrName is empty or blank

java.lang.IllegalStateException - when the document this instance belongs to is closed

attributes

java.util.Map<java.lang.String,java.lang.String> attributes()

Returns an immutable map that contains attributes of the element. Each map entry represents a pair of strings where key stands for the attribute name and value stands for the attribute value. Returns an empty map if the element does not have attributes.

Throws:

java.lang.IllegalStateException - when the document this instance belongs to is closed

innerHtml

java.lang.String innerHtml()

Returns a string that represents the HTML content of this element or an empty string if the element does not have the inner HTML.

Throws:

java.lang.IllegalStateException - when the document this instance belongs to is closed

innerHtml

boolean innerHtml(java.lang.String html)

Replaces the HTML content of this element with the given html.

Parameters:

html - a new HTML content of this element

Returns:

true when the HTML content of the element was successfully replaced

Throws:

java.lang.IllegalStateException - when the document this instance belongs to is closed

innerText

java.lang.String innerText()

Returns a string that represents the text content of the element and its descendants. This method can return an empty string if the element does not have a content.

Throws:

java.lang.IllegalStateException - when the document this instance belongs to is closed

innerText

boolean innerText(java.lang.String innerText)

Replaces the text content of the element with the given innerText value. Assigning a new value to the inner text will destroy any descendants of the element.

Parameters:

innerText - a new text content of the element

Returns:

true when the text content of the element was successfully replaced

Throws:

java.lang.IllegalStateException - when the document this instance belongs to is closed

boundingClientRect

Rect boundingClientRect()

Returns a Rect object representing the bounds of the element and its position relative to the top-left of the viewport of the current document.

This method can return a Rect with zero width, height, x, and y if the element has the hidden attribute or the CSS style of the element contains display: none; statement.

The amount of scrolling that has been done of the viewport area (or any other scrollable element) is taken into account when computing the bounding rectangle. This means that the rectangle's boundary edges (top, left, bottom, and right) change their values every time the scrolling position changes (because their values are relative to the viewport and not absolute). If you need the bounding rectangle relative to the top-left corner of the document, just add the current scrolling position to the top and left properties (these can be obtained using window.scrollX and window.scrollY) to get a bounding rectangle which is independent from the current scrolling position.

Throws:

java.lang.IllegalStateException - when the document this instance belongs to is closed