Package com.teamdev.jxbrowser.dom

Interface Element

All Superinterfaces:
EventTarget, Node, SearchContext
All Known Subinterfaces:
FormControlElement, FormElement, FrameElement, ImageElement, InputElement, OptionElement, SelectElement, TextAreaElement
public interface Element extends Node
An HTML DOM element.

All HTML element interfaces derive from this interface.

  • Method Details

    • attributeValue

      String attributeValue(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:
      IllegalArgumentException - when attrName is empty or blank
      ObjectClosedException - when this instance is closed

    • putAttribute

      void putAttribute(String attrName, 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:
      IllegalArgumentException - when attrName is empty or blank
      ObjectClosedException - when this instance is closed

    • removeAttribute

      void removeAttribute(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:
      IllegalArgumentException - when attrName is empty or blank
      ObjectClosedException - when this instance is closed

    • hasAttribute

      boolean hasAttribute(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:
      IllegalArgumentException - when attrName is empty or blank
      ObjectClosedException - when this instance is closed

    • attributes

      Map<String,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:
      ObjectClosedException - when this instance is closed

    • attributeNodes

      List<Attribute> attributeNodes()
      Returns an immutable list that contains attribute nodes of the element. Each list entry represents an attribute node. Returns an empty list if the element does not have attributes.
      Throws:
      ObjectClosedException - when this instance is closed

    • innerHtml

      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:
      ObjectClosedException - when this instance is closed

    • innerHtml

      boolean innerHtml(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:
      ObjectClosedException - when this instance is closed

    • outerHtml

      String outerHtml()
      Returns a string that represents an HTML serialization of this element and its descendants.
      Throws:
      ObjectClosedException - when this instance is closed
      Since:
      7.1

    • outerHtml

      boolean outerHtml(String html)
      Replaces the element and all of its descendants with a new DOM tree constructed by parsing the given html.
      Parameters:
      html - a new HTML of this element
      Returns:
      true when the HTML of the element was successfully replaced
      Throws:
      ObjectClosedException - when this instance is closed
      Since:
      7.1

    • innerText

      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:
      ObjectClosedException - when this instance is closed

    • innerText

      boolean innerText(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:
      ObjectClosedException - when this instance 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:
      ObjectClosedException - when this instance is closed

    • focus

      void focus()
      Sets focus on this element, if it can be focused. The focused element is the element which will receive keyboard and similar events by default.

      This method does nothing if the browser instance where the web page with this element is loaded is not focused. To programmatically focus the browser instance use the Browser.focus() method.

      Throws:
      ObjectClosedException - when this instance is closed
      Since:
      7.1

    • blur

      void blur()
      Removes keyboard focus from the current element.

      This method does nothing if the browser instance where the web page with this element is loaded is not focused. To programmatically focus the browser instance use the Browser.focus() method.

      Throws:
      ObjectClosedException - when this instance is closed
      Since:
      7.1

    • scrollIntoView

      void scrollIntoView(Element.AlignTo alignTo)
      Scrolls the element's parent container such that the element on which this method is called is visible to the user.

      Note: that the element may not be scrolled completely to the top or bottom depending on the layout of other elements.

      Parameters:
      alignTo - describes how the element will be aligned to the visible area of the scrollable ancestor
      Throws:
      ObjectClosedException - when the document of this element is closed
      Since:
      7.5