Element (Java Platform SE 8 )

All Superinterfaces:

Node

All Known Subinterfaces:

Detail， DetailEntry， SOAPBody， SOAPBodyElement， SOAPElement， SOAPEnvelope， SOAPFault， SOAPFaultElement， SOAPHeader， SOAPHeaderElement

所有已知实现类：

IIOMetadataNode
```
public interface Element
extends Node
```
的 Element接口表示一个元素在HTML或XML文档。元素可能具有相关的属性；因为 Element接口继承 Node，通用 Node接口属性 attributes可以用于检索一个元素的所有属性的设置。在 Element接口来检索一个 Attr对象的名称或名称属性值的方法。在XML中，其中一个属性值可以包含实体引用，一个 Attr对象应检索研究可能相当复杂的亚树表示的属性值。在HTML中，另一方面，所有的属性都有简单的字符串值，方法直接访问一个属性的值可以被用来作为一个方便。
在DOM级别2 注：，方法normalize是继承了Node界面，很是感动。

又见Document Object Model (DOM) Level 3 Core Specification。

Field Summary
- Fields inherited from interface org.w3c.dom.Node
  ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`String`	`getAttribute(String name)` 通过名称检索属性值。
`Attr`	`getAttributeNode(String name)` 通过名称检索属性节点。
`Attr`	`getAttributeNodeNS(String namespaceURI, String localName)` 检索一个 `Attr`节点的本地名称和命名空间URI。
`String`	`getAttributeNS(String namespaceURI, String localName)` 检索属性值的本地名称和命名空间URI。
`NodeList`	`getElementsByTagName(String name)` 返回一个 `NodeList`所有后裔 `Elements`与给定的标签名称，在文档顺序。
`NodeList`	`getElementsByTagNameNS(String namespaceURI, String localName)` 按照文档顺序返回一个 `NodeList`所有后代 `Elements`与给定的本地名称和命名空间URI。
`TypeInfo`	`getSchemaTypeInfo()` 与此元素关联的类型信息。
`String`	`getTagName()` 元素的名称。
`boolean`	`hasAttribute(String name)` `true`时返回具有给定名称的属性指定这个元素或具有默认值，否则 `false`。
`boolean`	`hasAttributeNS(String namespaceURI, String localName)` `true`时返回与给定的本地名称和命名空间URI属性指定该元素或具有默认值，否则 `false`。
`void`	`removeAttribute(String name)` 按名称删除属性。
`Attr`	`removeAttributeNode(Attr oldAttr)` 移除指定的属性节点。
`void`	`removeAttributeNS(String namespaceURI, String localName)` 删除一个属性的本地名称和命名空间URI。
`void`	`setAttribute(String name, String value)` 添加一个新属性。
`Attr`	`setAttributeNode(Attr newAttr)` 添加一个新的属性节点。
`Attr`	`setAttributeNodeNS(Attr newAttr)` 添加一个新属性。
`void`	`setAttributeNS(String namespaceURI, String qualifiedName, String value)` 添加一个新属性。
`void`	`setIdAttribute(String name, boolean isId)` 如果参数 `isId`是 `true`，这个方法声明指定的属性是用户自定义的ID属性。
`void`	`setIdAttributeNode(Attr idAttr, boolean isId)` 如果参数 `isId`是 `true`，这个方法声明指定的属性是用户自定义的ID属性。
`void`	`setIdAttributeNS(String namespaceURI, String localName, boolean isId)` 如果参数 `isId`是 `true`，这个方法声明指定的属性是用户自定义的ID属性。

Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

- 方法详细信息
  - getTagName
```
String getTagName()
```
    元素的名称。如果 Node.localName不同于 null，这个属性是一个合格的名字。例如，在
```
< elementexample id =“演示”>…< / elementexample >，
```
    tagName有价值 "elementExample"。注意，这是案例保存在XML中，当所有的DOM操作。HTML DOM返回在规范的大写形式的HTML元素的 tagName，无论案件在HTML源文件。
  - getAttribute
```
String getAttribute(String name)
```
    通过名称检索属性值。
    
    参数
    
    name -属性名称检索。
    
    结果
    
    的 Attr值作为一个字符串，或空字符串，如果属性没有指定或默认值。
  - setAttribute
```
void setAttribute(String name,
                  String value)
           throws DOMException
```
    添加一个新属性。如果在元素中已经存在该名称的属性，它的值将被更改为值参数的值。此值是一个简单的字符串，它没有被解析为它被设置。因此，任何标记（如语法被确认为实体引用）被视为文本文本，并需要适当地逃避执行时，它被写出来。为了指定一个属性值包含实体引用，用户必须创建一个 Attr节点加上任何 Text和 EntityReference节点，构建相应的子树，并使用 setAttributeNode指定它作为一个属性的值。
    to集属性与合格的名称和命名空间URI使用 setAttributeNS方法。
    
    参数
    
    name -属性来创建或更改名称。
    
    value值设置为字符串形式。
    
    异常
    
    DOMException - invalid_character_err：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的名称不是一个XML的名字了。
    no_modification_allowed_err：如果这个节点是只读了。
  - removeAttribute
```
void removeAttribute(String name)
              throws DOMException
```
    按名称删除属性。如果删除的属性的默认值是在DTD中定义，一个新的属性将直接使用默认值以及对应的命名空间URI、本地名称和前缀适用时。实施可以处理从其它模式类似但应用程序应使用 Document.normalizeDocument()保证这些信息是最新的默认值。
    if这个名字没有属性被发现，这个方法没有效果。
    to删除属性的本地名称和命名空间URI，使用 removeAttributeNS方法。
    
    参数
    
    name -属性的名称删除。
    
    异常
    
    DOMException - no_modification_allowed_err：如果这个节点是只读了。
  - getAttributeNode
```
Attr getAttributeNode(String name)
```
    通过名称检索属性节点。
    to检索属性节点的名称和命名空间URI使用 getAttributeNodeNS方法。
    
    参数
    
    name -名称（ nodeName）的属性来检索。
    
    结果
    
    具有指定名称的 Attr节点（ nodeName）或 null如果没有这样的属性。
  - setAttributeNode
```
Attr setAttributeNode(Attr newAttr)
               throws DOMException
```
    添加一个新的属性节点。如果该名称的属性（ nodeName）已经存在的元素，它是由新的代替。用自己替换一个属性节点没有效果。
    to添加新属性节点与一个合格的名称和命名空间URI使用 setAttributeNodeNS方法。
    
    参数
    
    newAttr - Attr节点添加到属性表。
    
    结果
    
    如果 newAttr属性将取代现有的属性，更换 Attr节点返回，否则返回 null。
    
    异常
    
    DOMException - wrong_document_err：如果 newAttr是从一个比创建元素的不同文件创建了。
    no_modification_allowed_err：如果这个节点是只读了。
    inuse_attribute_err：如果 newAttr已经是另一个对象的一个属性，提出 Element。DOM节点的用户必须显式地克隆 Attr重复使用在其他元素。
  - removeAttributeNode
```
Attr removeAttributeNode(Attr oldAttr)
                  throws DOMException
```
    移除指定的属性节点。如果删除的 Attr节点的默认值是在DTD中定义，一个新的节点立即出现与默认值以及对应的命名空间URI、本地名称和前缀适用时。实施可以处理从其它模式类似但应用程序应使用 Document.normalizeDocument()保证这些信息是最新的默认值。
    
    参数
    
    oldAttr - Attr节点从属性列表中删除。
    
    结果
    
    的 Attr节点被删除。
    
    异常
    
    DOMException - no_modification_allowed_err：如果这个节点是只读了。
    not_found_err：如果 oldAttr不是一个元素的属性了。
  - getElementsByTagName
```
NodeList getElementsByTagName(String name)
```
    返回一个 NodeList所有后裔 Elements与给定的标签名称，在文档顺序。
    
    参数
    
    name -标记的名称匹配。特殊值“*”匹配所有标签。
    
    结果
    
    Element节点列表匹配。
  - getAttributeNS
```
String getAttributeNS(String namespaceURI,
                      String localName)
               throws DOMException
```
    检索属性值的本地名称和命名空间URI。
    per [ XML Namespaces ]，应用程序必须使用价值 null作为方法的 namespaceURI参数如果他们希望没有命名空间。
    
    参数
    
    namespaceURI -属性来检索命名空间URI。
    
    检索 localName -属性的本地名称。
    
    结果
    
    的 Attr值作为一个字符串，或空字符串，如果属性没有指定或默认值。
    
    异常
    
    DOMException - not_supported_err：可提高如果实现不支持此功能 "XML"通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。
    
    从以下版本开始：
    
    DOM级别2
  - setAttributeNS
```
void setAttributeNS(String namespaceURI,
                    String qualifiedName,
                    String value)
             throws DOMException
```
    添加一个新属性。如果用相同的本地名称和命名空间URI的属性已经存在的元素，其前缀改为的 qualifiedName前缀部分，其值改为 value参数。此值是一个简单的字符串，它没有被解析为它被设置。因此，任何标记（如语法被确认为实体引用）被视为文本文本，并需要适当地逃避执行时，它被写出来。为了指定一个属性值包含实体引用，用户必须创建一个 Attr节点加上任何 Text和 EntityReference节点，构建相应的子树，并使用 setAttributeNodeNS或 setAttributeNode指定它作为一个属性的值。
    per [ XML Namespaces ]，应用程序必须使用价值 null作为方法的 namespaceURI参数如果他们希望没有命名空间。
    
    参数
    
    namespaceURI -属性来创建或修改命名空间URI。
    
    qualifiedName -属性来创建或更改名称。
    
    value -设置为字符串形式的价值。
    
    异常
    
    DOMException - invalid_character_err：如果根据在使用中的 Document.xmlVersion属性指定的XML版本指定的名称不是XML的名字了。
    no_modification_allowed_err：如果这个节点是只读了。
    namespace_err：如果 qualifiedName XML规范畸形每命名空间提出，如果 qualifiedName有前缀和 namespaceURI是 null，如果 qualifiedName有前缀是“XML”和 namespaceURI不同于“ http://www.w3.org/XML/1998/namespace”，如果 qualifiedName或它的前缀是“xmlns”和 namespaceURI不同“ http://www.w3.org/2000/xmlns/”，或者是“z-ba928b34-37bd-4e48-9b06 namespaceURI—d2cd61ba64d0”既不是 qualifiedName和前缀是“xmlns”。
    not_supported_err：可提高如果实现不支持此功能 "XML"通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。
    
    从以下版本开始：
    
    DOM级别2
  - removeAttributeNS
```
void removeAttributeNS(String namespaceURI,
                       String localName)
                throws DOMException
```
    删除一个属性的本地名称和命名空间URI。如果删除的属性的默认值是在DTD中定义，一个新的属性将直接使用默认值以及对应的命名空间URI、本地名称和前缀适用时。实施可以处理从其它模式类似但应用程序应使用 Document.normalizeDocument()保证这些信息是最新的默认值。
    if这个本地名称和命名空间URI属性是没有发现的，这个方法没有效果。
    per [ XML Namespaces ]，应用程序必须如果他们希望没有命名空间的使用价值 null作为方法参数的 namespaceURI。
    
    参数
    
    namespaceURI -属性删除命名空间URI。
    
    localName -属性的本地名称删除。
    
    异常
    
    DOMException - no_modification_allowed_err：如果这个节点是只读了。
    not_supported_err：可提高如果实现不支持此功能 "XML"通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。
    
    从以下版本开始：
    
    DOM级别2
  - getAttributeNodeNS
```
Attr getAttributeNodeNS(String namespaceURI,
                        String localName)
                 throws DOMException
```
    检索一个 Attr节点的本地名称和命名空间URI。
    per [ XML Namespaces ]，应用程序必须使用价值 null作为方法的 namespaceURI参数如果他们希望没有命名空间。
    
    参数
    
    namespaceURI -属性来检索命名空间URI。
    
    localName -属性的本地名称检索。
    
    结果
    
    的 Attr节点指定属性的本地名称和命名空间URI或 null如果没有这样的属性。
    
    异常
    
    DOMException - not_supported_err：可提高如果实现不支持此功能 "XML"通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。
    
    从以下版本开始：
    
    DOM级别2
  - setAttributeNodeNS
```
Attr setAttributeNodeNS(Attr newAttr)
                 throws DOMException
```
    添加一个新属性。如果这个地方名称的属性和命名空间URI已存在的元素，它是由新的代替。用自己替换一个属性节点没有效果。
    per [ XML Namespaces ]，应用程序必须使用价值 null作为方法的 namespaceURI参数如果他们希望没有命名空间。
    
    参数
    
    newAttr - Attr节点添加到属性表。
    
    结果
    
    如果 newAttr属性具有相同的本地名称和命名空间URI将取代现有的属性，更换 Attr节点返回，否则返回 null。
    
    异常
    
    DOMException - wrong_document_err：如果 newAttr是从一个比创建元素的不同文件创建了。
    no_modification_allowed_err：如果这个节点是只读了。
    inuse_attribute_err：如果 newAttr已经是另一个对象的一个属性，提出 Element。DOM节点的用户必须显式地克隆 Attr重复使用在其他元素。
    not_supported_err：可提高如果实现不支持此功能 "XML"通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。
    
    从以下版本开始：
    
    DOM级别2
  - getElementsByTagNameNS
```
NodeList getElementsByTagNameNS(String namespaceURI,
                                String localName)
                         throws DOMException
```
    按照文档顺序返回一个 NodeList所有后代 Elements与给定的本地名称和命名空间URI。
    
    参数
    
    namespaceURI -元素的命名空间URI匹配。特殊值“*”匹配所有的命名空间。
    
    localName -元素的本地名称匹配。特别值“*”匹配所有的本地名称。
    
    结果
    
    一个新的 NodeList对象包含所有匹配的 Elements。
    
    异常
    
    DOMException - not_supported_err：可提高如果实现不支持此功能 "XML"通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。
    
    从以下版本开始：
    
    DOM级别2
  - hasAttribute
```
boolean hasAttribute(String name)
```
    true时返回具有给定名称的属性指定这个元素或具有默认值，否则 false。
    
    参数
    
    name -属性的名字找。
    
    结果
    
    true如果具有给定名称的属性是该元素指定或默认值，否则 false。
    
    从以下版本开始：
    
    DOM级别2
  - hasAttributeNS
```
boolean hasAttributeNS(String namespaceURI,
                       String localName)
                throws DOMException
```
    true时返回与给定的本地名称和命名空间URI属性指定该元素或具有默认值，否则 false。
    per [ XML Namespaces ]，应用程序必须使用价值 null作为方法的 namespaceURI参数如果他们希望没有命名空间。
    
    参数
    
    namespaceURI -属性查找命名空间URI。
    
    localName -本地的属性名字找。
    
    结果
    
    true如果与给定的本地名称和命名空间URI属性指定或对该元素的默认值，否则 false。
    
    异常
    
    DOMException - not_supported_err：可提高如果实现不支持此功能 "XML"通过文件暴露了语言不支持XML命名空间（如[ HTML 4.01 ]）。
    
    从以下版本开始：
    
    DOM级别2
  - getSchemaTypeInfo
```
TypeInfo getSchemaTypeInfo()
```
    与此元素关联的类型信息。
    
    从以下版本开始：
    
    DOM级别3
  - setIdAttribute
```
void setIdAttribute(String name,
                    boolean isId)
             throws DOMException
```
    如果参数 isId是 true，这个方法声明指定的属性是用户自定义的ID属性。这会影响 Attr.isId价值和 Document.getElementById的行为，但不改变，可能在使用任何模式，特别是这并不影响指定的 Attr节点 Attr.schemaTypeInfo。使用价值 false为参数 isId到undeclare属性是用户自定义的ID属性。
    指定的本地名称和命名空间URI属性，使用 setIdAttributeNS方法。
    
    参数
    
    name -属性的名称。
    
    isId -属性是否是一个类型的ID。
    
    异常
    
    DOMException - no_modification_allowed_err：如果这个节点是只读了。
    not_found_err：如果指定的节点不是此元素的属性了。
    
    从以下版本开始：
    
    DOM级别3
  - setIdAttributeNS
```
void setIdAttributeNS(String namespaceURI,
                      String localName,
                      boolean isId)
               throws DOMException
```
    如果参数 isId是 true，这个方法声明指定的属性是用户自定义的ID属性。这会影响 Attr.isId价值和 Document.getElementById的行为，但不改变，可能在使用任何模式，特别是这并不影响指定的 Attr节点 Attr.schemaTypeInfo。使用价值 false为参数 isId到undeclare属性是用户自定义的ID属性。
    
    参数
    
    namespaceURI -属性的命名空间URI。
    
    localName -属性的本地名称。
    
    isId -属性是否是一个类型的ID。
    
    异常
    
    DOMException - no_modification_allowed_err：如果这个节点是只读了。
    not_found_err：如果指定的节点不是此元素的属性了。
    
    从以下版本开始：
    
    DOM级别3
  - setIdAttributeNode
```
void setIdAttributeNode(Attr idAttr,
                        boolean isId)
                 throws DOMException
```
    如果参数 isId是 true，这个方法声明指定的属性是用户自定义的ID属性。这会影响 Attr.isId价值和 Document.getElementById的行为，但不改变，可能在使用任何模式，特别是这并不影响指定的 Attr节点 Attr.schemaTypeInfo。使用价值 false为参数 isId到undeclare属性是用户自定义的ID属性。
    
    参数
    
    idAttr -属性节点。
    
    isId -属性是否是一个类型的ID。
    
    异常
    
    DOMException - no_modification_allowed_err：如果这个节点是只读了。
    not_found_err：如果指定的节点不是此元素的属性了。
    
    从以下版本开始：
    
    DOM级别3

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface Element

Field Summary

Fields inherited from interface org.w3c.dom.Node

方法摘要

Methods inherited from interface org.w3c.dom.Node

方法详细信息

getTagName

getAttribute

setAttribute

removeAttribute

getAttributeNode

setAttributeNode

removeAttributeNode

getElementsByTagName

getAttributeNS

setAttributeNS

removeAttributeNS

getAttributeNodeNS

setAttributeNodeNS

getElementsByTagNameNS

hasAttribute

hasAttributeNS

getSchemaTypeInfo

setIdAttribute

setIdAttributeNS

setIdAttributeNode