DOMNode (JxBrowser 6.23.1 API)

All Superinterfaces:

DOMEventTarget, SearchContext

All Known Subinterfaces:

DOMElement, DOMFormControlElement, DOMFormElement, DOMFrameElement, DOMInputElement, DOMOptionElement, DOMSelectElement, DOMTextAreaElement
```
public interface DOMNode
extends DOMEventTarget, SearchContext
```
Represents a singe HTML DOM node in the document tree. All JxBrowser DOM objects implement the DOMNode interface.
表示文档树中的单一HTML DOM节点。所有JxBrowser DOM对象都实现DOMNode接口。

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`boolean`	`appendChild(DOMNode childNode)` Appends a node as the last child of the current node. 将一个节点追加为当前节点的最后一个子节点。
`void`	`click()` Simulates click on the current Node. 模拟单击当前节点。
`DOMNodePosition`	`compareDocumentPosition(DOMNode targetNode)` Compares position of the current node against another node in a DOM tree. 将当前节点的位置与DOM树中的另一个节点进行比较。
`java.util.List<DOMNode>`	`getChildren()` Returns a list of child nodes of this node or empty list when this node doesn't have children. 返回此节点的子节点列表；如果此节点没有子节点，则返回空列表。
`DOMNode`	`getNextSibling()` Returns the node immediately following this one in its parent's children list, or `null` if this node is the last node in the list. 返回其父节点的子节点列表中紧随该节点之后的节点；如果此节点是列表中的最后一个节点，则返回null。
`java.lang.String`	`getNodeName()` Returns the name of this node, depending on its `DOMNodeType`. 返回此节点的名称，具体取决于其DOMNodeType。
`DOMNodeType`	`getNodeType()` Returns the type of this node. 返回此节点的类型。
`java.lang.String`	`getNodeValue()` Returns the value of this node, depending on its `DOMNodeType`. 返回此节点的值，具体取决于其DOMNodeType。
`DOMNode`	`getParent()` Returns parent node or `null` if there's no parent. 返回父节点；如果没有父节点，则返回null。
`long`	`getParentFrameId()` Returns the ID of the frame this DOMNode belongs to. 返回此DOMNode所属的帧的ID。
`DOMNode`	`getPreviousSibling()` Returns the node immediately preceding this one in its parent's children list, or `null` if this node is the first node in that list. 返回其父级的子级列表中紧接该节点之前的节点；如果此节点是该列表中的第一个节点，则返回null。
`java.lang.String`	`getTextContent()` Returns text content of the node and its descendants. 返回节点及其后代的文本内容。
`java.lang.String`	`getXPath()` Returns a string that represents XPath to the current Node. 返回表示当前节点的XPath的字符串。
`boolean`	`insertChild(DOMNode node, DOMNode beforeNode)` Inserts a new `node` before an existing `beforeNode`. 在现有的beforeNode之前插入一个新节点。
`boolean`	`removeChild(DOMNode childNode)` Removes a child node and notifies whether child node was removed from the current node successfully or not. 删除子节点，并通知是否已成功将其从当前节点中删除。
`boolean`	`replaceChild(DOMNode newNode, DOMNode oldNode)` Replaces existing child node with a new node. 用新节点替换现有子节点。
`void`	`setNodeValue(java.lang.String value)` Sets a new node value. 设置新的节点值。
`void`	`setTextContent(java.lang.String textContent)` Updates `textContent` property of the node. 更新节点的textContent属性。

Methods inherited from interface com.teamdev.jxbrowser.chromium.dom.events.DOMEventTarget
addEventListener, dispatchEvent, getEventListeners, removeEventListener

Methods inherited from interface com.teamdev.jxbrowser.chromium.dom.SearchContext
evaluate, evaluate, findElement, findElements

- Method Detail
  - getNodeName
```
java.lang.String getNodeName()
```
    Returns the name of this node, depending on its DOMNodeType.
    返回此节点的名称，具体取决于其DOMNodeType。
    
    Returns:
    
    the name of this node. 该节点的名称。
  - getNodeValue
```
java.lang.String getNodeValue()
```
    Returns the value of this node, depending on its DOMNodeType.
    返回此节点的值，具体取决于其DOMNodeType。
    
    Returns:
    
    the value of this node. Can be null or empty string. 该节点的值。可以是或为空字符串。
  - setNodeValue
```
void setNodeValue(java.lang.String value)
```
    Sets a new node value.
    设置新的节点值。
    
    Parameters:
    
    value - the new node value. -新的节点值。
  - getNodeType
```
DOMNodeType getNodeType()
```
    Returns the type of this node.
    返回此节点的类型。
  - getParent
```
DOMNode getParent()
```
    Returns parent node or null if there's no parent.
    返回父节点；如果没有父节点，则返回null。
  - getChildren
```
java.util.List<DOMNode> getChildren()
```
    Returns a list of child nodes of this node or empty list when this node doesn't have children.
    返回此节点的子节点列表；如果此节点没有子节点，则返回空列表。
  - getNextSibling
```
DOMNode getNextSibling()
```
    Returns the node immediately following this one in its parent's children list, or null if this node is the last node in the list.
    返回其父节点的子节点列表中紧随该节点之后的节点；如果此节点是列表中的最后一个节点，则返回null。
    
    Returns:
    
    the node immediately following this one in its parent's children list, or null if this node is the last node in that list. 在其父级的子级列表中紧随其后的节点，或者该节点是该列表中的最后一个节点。
    
    Since:
    
    6.3
  - getPreviousSibling
```
DOMNode getPreviousSibling()
```
    Returns the node immediately preceding this one in its parent's children list, or null if this node is the first node in that list.
    返回其父级的子级列表中紧接该节点之前的节点；如果此节点是该列表中的第一个节点，则返回null。
    
    Returns:
    
    the node immediately preceding this one in its parent's children list, or null if this node is the first node in that list. 在其父项的子项列表中紧接该节点之前的节点，或者如果此节点是该列表中的第一个节点。
    
    Since:
    
    6.3
  - click
```
void click()
```
    Simulates click on the current Node.
    模拟单击当前节点。
  - insertChild
```
boolean insertChild(DOMNode node,
                    DOMNode beforeNode)
```
    Inserts a new node before an existing beforeNode. The new node could be an existing node in the document, or you can create and insert a new node. If the node is existing node, it will be moved to new location in the document.
    在现有的beforeNode之前插入一个新节点。新节点可以是文档中的现有节点，也可以创建并插入新节点。如果该节点是现有节点，它将被移动到文档中的新位置。
    
    Parameters:
    
    node - the node to insert. -要插入的节点。
    
    beforeNode - the node before which the node will be inserted. -将在其之前插入的节点。
    
    Returns:
    
    true if node was successfully inserted. 如果成功插入。
    
    Throws:
    
    java.lang.IllegalArgumentException - when node is null or beforeNode is null.
  - replaceChild
```
boolean replaceChild(DOMNode newNode,
                     DOMNode oldNode)
```
    Replaces existing child node with a new node. The new node could be an existing node in the document, or you can create a new node. If the newNode is existing node, it will be moved to new location in the document. The old node could be used for inserting/appending it into the document later.
    用新节点替换现有子节点。新节点可以是文档中的现有节点，也可以创建一个新节点。如果newNode是现有节点，它将被移动到文档中的新位置。以后可以使用旧节点将其插入/添加到文档中。
    
    Parameters:
    
    newNode - the new node to replace. -要替换的新节点。
    
    oldNode - the existing node, which will be replaced by newNode. -现有节点，将由替换。
    
    Returns:
    
    true if the oldNode was successfully replaced with the newNode. 如果成功将替换为。
    
    Throws:
    
    java.lang.IllegalArgumentException - when newNode is null or oldNode is null.
  - removeChild
```
boolean removeChild(DOMNode childNode)
```
    Removes a child node and notifies whether child node was removed from the current node successfully or not.
    删除子节点，并通知是否已成功将其从当前节点中删除。
    
    Parameters:
    
    childNode - the node to remove. -要删除的节点。
    
    Returns:
    
    true if the childNode was successfully removed. 如果成功删除了。
    
    Throws:
    
    java.lang.IllegalArgumentException - when childNode is null or it's not a child of the current node.
  - appendChild
```
boolean appendChild(DOMNode childNode)
```
    Appends a node as the last child of the current node. The new node could be an existing node in the document, or you can create a new node. If the childNode is existing node, it will be moved to new location in the document.
    将一个节点追加为当前节点的最后一个子节点。新节点可以是文档中的现有节点，也可以创建一个新节点。如果childNode是现有节点，它将被移动到文档中的新位置。
    
    Parameters:
    
    childNode - the node to append. -要追加的节点。
    
    Returns:
    
    true if the childNode was successfully appended. 如果成功附加。
    
    Throws:
    
    java.lang.IllegalArgumentException - when childNode is null.
  - getTextContent
```
java.lang.String getTextContent()
```
    Returns text content of the node and its descendants.
    This method returns null if the element is a document, a document type, or a notation. To grab all of the text and CDATA data for the whole document.
    If the node is a CDATA section, a comment, a processing instruction, or a text node, this method returns the text inside this node (the getNodeValue()).
    For other node types, this method returns the concatenation of the textContent attribute value of every child node, excluding comments and processing instruction nodes. This is an empty string if the node has no children.
    Differences from innerText
    - Note that while textContent gets the content of all elements, including <script> and <style> elements, the mostly equivalent innerText property, does not.
    - innerText is also aware of style and will not return the text of hidden elements, whereas textContent will.
    - As innerText is aware of CSS styling, it will trigger a reflow, whereas textContent will not.
    返回节点及其后代的文本内容。如果元素是文档，文档类型或符号，则此方法返回null。抓取整个文档的所有文本和CDATA数据。如果该节点是CDATA节，注释，处理指令或文本节点，则此方法返回此节点内的文本（getNodeValue（））。对于其他节点类型，此方法返回每个子节点的textContent属性值的串联，不包括注释和处理指令节点。如果节点没有子节点，则为空字符串。与innerText的区别请注意，虽然textContent获取所有元素的内容，包括
    
    Returns:
    
    the text content of the node and its descendants. 节点及其后代的文本内容。
  - setTextContent
```
void setTextContent(java.lang.String textContent)
```
    Updates textContent property of the node. Setting this property on a node removes all of its children and replaces them with a single text node with the given value.
    更新节点的textContent属性。在节点上设置此属性将删除其所有子节点，并将其替换为具有给定值的单个文本节点。
    
    Parameters:
    
    textContent - content of the text node. -文本节点的内容。
    
    Throws:
    
    java.lang.IllegalArgumentException - when textContent is null.
  - getParentFrameId
```
long getParentFrameId()
```
    Returns the ID of the frame this DOMNode belongs to.
    返回此DOMNode所属的帧的ID。
    
    Returns:
    
    the ID of the frame this DOMNode belongs to or 0 when the parent document does not belong to a frame. 此DOMNode所属的框架的ID，或者当父文档不属于框架时的ID。
    
    Since:
    
    6.15
  - getXPath
```
java.lang.String getXPath()
```
    Returns a string that represents XPath to the current Node.
    返回表示当前节点的XPath的字符串。
    
    Returns:
    
    a string that represents XPath to the current Node. Can be null or empty string. 表示当前节点的XPath的字符串。可以是或为空字符串。
    
    Since:
    
    6.15
  - compareDocumentPosition
```
DOMNodePosition compareDocumentPosition(DOMNode targetNode)
```
    Compares position of the current node against another node in a DOM tree.
    将当前节点的位置与DOM树中的另一个节点进行比较。
    
    Parameters:
    
    targetNode - DOMNode to compare with. -比较。
    
    Returns:
    
    position of the targetNode against the current node. 当前节点的位置。
    
    Throws:
    
    java.lang.IllegalArgumentException - when targetNode is null.

Interface DOMNode

Method Summary

Methods inherited from interface com.teamdev.jxbrowser.chromium.dom.events.DOMEventTarget

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

Method Detail

getNodeName

getNodeValue

setNodeValue

getNodeType

getParent

getChildren

getNextSibling

getPreviousSibling

click

insertChild

replaceChild

removeChild

appendChild

getTextContent

setTextContent

getParentFrameId

getXPath

compareDocumentPosition