com.teamdev.jxbrowser.chromium.dom

Interface DOMDocument

All Superinterfaces:

SearchContext

public interface DOMDocument
extends SearchContext

Represents DOM HTML document of the web page.

表示网页的DOM HTML文档。

Method Summary

Modifier and Type	Method and Description
DOMElement	createElement(java.lang.String tagName) Creates and returns a new DOM element with the specified tag name. 创建并返回具有指定标签名称的新DOM元素。
DOMEvent	createEvent(DOMEventType eventType, DOMEventParams params) Creates a new DOMEvent object with the given eventType and params. 使用给定的eventType和params创建一个新的DOMEvent对象。
DOMKeyEvent	createKeyEvent(DOMEventType eventType, DOMKeyEventParams params) Creates a new DOMKeyEvent object with the given eventType and params. 使用给定的eventType和params创建一个新的DOMKeyEvent对象。
DOMMouseEvent	createMouseEvent(DOMEventType eventType, DOMMouseEventParams params) Creates a new DOMMouseEvent object with the given eventType and params. 使用给定的eventType和params创建一个新的DOMMouseEvent对象。
DOMNode	createTextNode() Creates and returns a new Text DOM node with DOMNodeType.TextNode type. 创建并返回具有DOMNodeType.TextNode类型的新Text DOM节点。
DOMNode	createTextNode(java.lang.String text) Returns a new Text DOM node with DOMNodeType.TextNode type. 返回具有DOMNodeType.TextNode类型的新Text DOM节点。
DOMUIEvent	createUIEvent(DOMEventType eventType, DOMUIEventParams params) Creates a new DOMUIEvent object with the given eventType and params. 使用给定的eventType和params创建一个新的DOMUIEvent对象。
java.lang.String	getBaseURI() Returns the absolute base URL of the document 返回文档的绝对基础URL
DOMElement	getDocumentElement() Returns the document HTML element that usually represents HTML tag. 返回通常表示HTML标签的文档HTML元素。

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

evaluate, evaluate, findElement, findElements

Method Detail

getDocumentElement

DOMElement getDocumentElement()

Returns the document HTML element that usually represents HTML tag. This method can return null if document element is not available (e.g. the web page of this document was disposed).

返回通常表示HTML标签的文档HTML元素。如果文档元素不可用（例如，放置了此文档的网页），则此方法可以返回null。

Returns:

the document HTML element that usually represents HTML tag or null if document element is not available. 通常表示HTML标记或如果文档元素不可用的文档HTML元素。

createElement

DOMElement createElement(java.lang.String tagName)

Creates and returns a new DOM element with the specified tag name.

创建并返回具有指定标签名称的新DOM元素。

Parameters:

tagName - the tag name (e.g. "A", "P", "DIV") of the new DOM element. -新DOM元素的标签名称（例如“ A”，“ P”，“ DIV”）。

Returns:

the new DOMElement or null if tagName is wrong. 新的或如果是错误的。

Throws:

java.lang.IllegalArgumentException - when tagName parameter is empty or null.

createTextNode

DOMNode createTextNode()

Creates and returns a new Text DOM node with DOMNodeType.TextNode type.

创建并返回具有DOMNodeType.TextNode类型的新Text DOM节点。

Returns:

the new Text DOM node with DOMNodeType.TextNode type. 类型的新Text DOM节点。

createTextNode

DOMNode createTextNode(java.lang.String text)

Returns a new Text DOM node with DOMNodeType.TextNode type.

返回具有DOMNodeType.TextNode类型的新Text DOM节点。

Parameters:

text - the string, which will be used to initialize node value. -字符串，将用于初始化节点值。

Returns:

the new Text DOM node with DOMNodeType.TextNode type. 类型的新Text DOM节点。

Throws:

java.lang.IllegalArgumentException - when text parameter is empty or null.

createEvent

DOMEvent createEvent(DOMEventType eventType,
                     DOMEventParams params)

Creates a new DOMEvent object with the given eventType and params. The event object can be dispatched at specific DOMEventTarget using the DOMEventTarget.dispatchEvent(DOMEvent) method.

使用给定的eventType和params创建一个新的DOMEvent对象。可以使用DOMEventTarget.dispatchEvent（DOMEvent）方法在特定的DOMEventTarget上调度事件对象。

Parameters:

eventType - the DOM event type. Cannot be null. -DOM事件类型。不可能是 。

params - the parameters of the event. Cannot be null. -事件的参数。不可能是 。

Returns:

a new DOMEvent object. 一个新的对象。

Throws:

DOMException - when document fails to create DOM event.

Since:

6.13

createUIEvent

DOMUIEvent createUIEvent(DOMEventType eventType,
                         DOMUIEventParams params)

Creates a new DOMUIEvent object with the given eventType and params. The event object can be dispatched at specific DOMEventTarget using the DOMEventTarget.dispatchEvent(DOMEvent) method.

使用给定的eventType和params创建一个新的DOMUIEvent对象。可以使用DOMEventTarget.dispatchEvent（DOMEvent）方法在特定的DOMEventTarget上调度事件对象。

Parameters:

eventType - the DOM event type. Cannot be null. -DOM事件类型。不可能是 。

params - the parameters of the event. Cannot be null. -事件的参数。不可能是 。

Returns:

a new DOMUIEvent object. 一个新的对象。

Throws:

DOMException - when document fails to create DOM event.

Since:

6.13

createMouseEvent

DOMMouseEvent createMouseEvent(DOMEventType eventType,
                               DOMMouseEventParams params)

Creates a new DOMMouseEvent object with the given eventType and params. The event object can be dispatched at specific DOMEventTarget using the DOMEventTarget.dispatchEvent(DOMEvent) method.

使用给定的eventType和params创建一个新的DOMMouseEvent对象。可以使用DOMEventTarget.dispatchEvent（DOMEvent）方法在特定的DOMEventTarget上调度事件对象。

Parameters:

eventType - the DOM event type. Cannot be null. -DOM事件类型。不可能是 。

params - the parameters of the event. Cannot be null. -事件的参数。不可能是 。

Returns:

a new DOMMouseEvent object. 一个新的对象。

Throws:

DOMException - when document fails to create DOM event.

Since:

6.13

createKeyEvent

DOMKeyEvent createKeyEvent(DOMEventType eventType,
                           DOMKeyEventParams params)

Creates a new DOMKeyEvent object with the given eventType and params. The event object can be dispatched at specific DOMEventTarget using the DOMEventTarget.dispatchEvent(DOMEvent) method.

Important: it's strongly recommended that the OnKeyDown, OnKeyUp, and OnKeyPress event types are used when creating DOM key event. With other event types, Chromium engine might fail to create DOM key event and throw DOMException.

使用给定的eventType和params创建一个新的DOMKeyEvent对象。可以使用DOMEventTarget.dispatchEvent（DOMEvent）方法在特定的DOMEventTarget上调度事件对象。重要说明：强烈建议在创建DOM键事件时使用OnKeyDown，OnKeyUp和OnKeyPress事件类型。对于其他事件类型，Chromium引擎可能无法创建DOM键事件并抛出DOMException。

Parameters:

eventType - the DOM event type. Cannot be null. -DOM事件类型。不可能是 。

params - the parameters of the event. Cannot be null. -事件的参数。不可能是 。

Returns:

a new DOMKeyEvent object. 一个新的对象。

Throws:

DOMException - when document fails to create DOM event.

Since:

6.13

getBaseURI

java.lang.String getBaseURI()

Returns the absolute base URL of the document

返回文档的绝对基础URL

Returns:

value of <base> element's href attribute if one is present

otherwise, currently loaded location (including "about:blank" value for the case when nothing is loaded)