模块  java.xml
软件包  org.w3c.dom

Interface Element

    • 方法详细信息

      • getTagName

        String getTagName()
        元素的名称。 如果Node.localName与null不同，则此属性是限定名称。 例如，在： 
          <elementExample id="demo"> ...
 </elementExample> ,
        tagName的值为"elementExample" 。 请注意，这是XML中的大小写保留，以及DOM的所有操作。 无论源HTML文档中的大小写如何，HTML DOM都会以规范的大写形式返回HTML元素的tagName 。

      • getAttribute

        String getAttribute​(String name)
        按名称检索属性值。
        参数
        name - 要检索的属性的名称。
        结果
        Attr值作为字符串，如果该属性没有指定或默认值，则为空字符串。

      • setAttribute

        void setAttribute​(String name,
                  String value)
           throws DOMException
        添加新属性。 如果元素中已存在具有该名称的属性，则其值将更改为value参数的值。 这个值是一个简单的字符串; 它没有被解析，因为它被设置。 因此，任何标记（例如被识别为实体引用的语法）都被视为文本文本，并且在写出时需要由实现适当地转义。 为了分配包含实体引用的属性值，用户必须创建一个Attr节点以及任何Text和EntityReference节点，构建相应的子树，并使用setAttributeNode将其指定为属性的值。
        要使用限定名称和名称空间URI设置属性，请使用setAttributeNS方法。
        参数
        name - 要创建或更改的属性的名称。
        value - 以字符串形式设置的值。
        异常
        DOMException - INVALID_CHARACTER_ERR：根据Document.xmlVersion属性中指定的使用的XML版本，如果指定的名称不是XML名称，则Document.xmlVersion此Document.xmlVersion 。
        NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。

      • removeAttribute

        void removeAttribute​(String name)
              throws DOMException
        按名称删除属性。 如果在DTD中定义了已删除属性的默认值，则会立即显示一个新属性，其中包含默认值以及相应的命名空间URI，本地名称和前缀（如果适用）。 实现可以类似地处理来自其他模式的默认值，但应用程序应使用Document.normalizeDocument()来保证此信息是最新的。
        如果未找到具有此名称的属性，则此方法无效。
        要按本地名称和名称空间URI删除属性，请使用removeAttributeNS方法。
        参数
        name - 要删除的属性的名称。
        异常
        DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。

      • getAttributeNode

        Attr getAttributeNode​(String name)
        按名称检索属性节点。
        要通过限定名称和名称空间URI检索属性节点，请使用getAttributeNodeNS方法。
        参数
        name - 要检索的属性的名称（ nodeName ）。
        结果
        具有指定名称的 Attr节点（ nodeName ）或 null如果没有此类属性）。

      • setAttributeNode

        Attr setAttributeNode​(Attr newAttr)
               throws DOMException
        添加新属性节点。 如果元素中已存在具有该名称的属性（ nodeName ），则该属性将替换为新属性。 单独替换属性节点无效。
        要添加具有限定名称和名称空间URI的新属性节点，请使用setAttributeNodeNS方法。
        参数
        newAttr - 要添加到属性列表的 Attr节点。
        结果
        如果 newAttr属性替换现有属性，则返回替换的 Attr节点，否则返回 null 。
        异常
        DOMException - WRONG_DOCUMENT_ERR：如果newAttr是从与创建该元素的文档不同的文档创建的，则newAttr 。
        NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。
        INUSE_ATTRIBUTE_ERR：如果newAttr已经是另一个Element对象的属性，则Element 。 DOM用户必须显式克隆Attr节点才能在其他元素中重用它们。

      • removeAttributeNode

        Attr removeAttributeNode​(Attr oldAttr)
                  throws DOMException
        删除指定的属性节点。 如果在DTD中定义了已删除的Attr节点的默认值，则会立即显示一个新节点，其中包含默认值以及相应的命名空间URI，本地名称和前缀（如果适用）。 实现可以类似地处理来自其他模式的默认值，但应用程序应使用Document.normalizeDocument()来保证此信息是最新的。
        参数
        oldAttr - 要从属性列表中删除的 Attr节点。
        结果
        已删除的 Attr节点。
        异常
        DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。
        NOT_FOUND_ERR：如果oldAttr不是元素的属性，则oldAttr 。

      • getElementsByTagName

        NodeList getElementsByTagName​(String name)
        返回 NodeList所有子孙的 Elements具有给定标记名称，在文档顺序。
        参数
        name - 要匹配的标记的名称。 特殊值“*”匹配所有标签。
        结果
        匹配 Element节点的列表。

      • getAttributeNS

        String getAttributeNS​(String namespaceURI,
                      String localName)
               throws DOMException
        按本地名称和名称空间URI检索属性值。
        根据[ XML Namespaces ]，如果方法希望没有名称空间，则必须使用值null作为方法的namespaceURI参数。
        参数
        namespaceURI - 要检索的属性的名称空间URI。
        localName - 要检索的属性的本地名称。
        结果
        Attr值为字符串，如果该属性没有指定或默认值，则为空字符串。
        异常
        DOMException - NOT_SUPPORTED_ERR：如果实现不支持功能 "XML"并且通过Document公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能 引发此问题 。
        从以下版本开始：
        1.4，DOM Level 2

      • setAttributeNS

        void setAttributeNS​(String namespaceURI,
                    String qualifiedName,
                    String value)
             throws DOMException
        添加新属性。 如果元素上已存在具有相同本地名称和名称空间URI的属性，则其前缀将更改为qualifiedName的前缀部分，并且其值将更改为value参数。 这个值是一个简单的字符串; 它没有被解析，因为它被设置。 因此，任何标记（例如被识别为实体引用的语法）都被视为文本文本，并且在写出时需要由实现适当地转义。 为了分配包含实体引用的属性值，用户必须创建一个Attr节点以及任何Text和EntityReference节点，构建相应的子树，并使用setAttributeNodeNS或setAttributeNode将其指定为属性的值。
        根据[ XML Namespaces ]，如果方法希望没有名称空间，则必须使用值null作为方法的namespaceURI参数。
        参数
        namespaceURI - 要创建或更改的属性的名称空间URI。
        qualifiedName - 要创建或更改的属性的限定名称。
        value - 以字符串形式设置的值。
        异常
        DOMException - INVALID_CHARACTER_ERR：如果指定的限定名称不是XML名称，则根据Document.xmlVersion属性中指定的XML版本Document.xmlVersion 。
        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/ ”不同，或者如果namespaceURI为“ http://www.w3.org/2000/xmlns/ ”且qualifiedName及其前缀均不是“xmlns”。
        NOT_SUPPORTED_ERR：如果实现不支持功能"XML"并且通过Document公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能引发此问题 。
        从以下版本开始：
        1.4，DOM Level 2

      • removeAttributeNS

        void removeAttributeNS​(String namespaceURI,
                       String localName)
                throws DOMException
        按本地名称和名称空间URI删除属性。 如果在DTD中定义了已删除属性的默认值，则会立即显示一个新属性，其中包含默认值以及相应的命名空间URI，本地名称和前缀（如果适用）。 实现可以类似地处理来自其他模式的默认值，但应用程序应使用Document.normalizeDocument()来保证此信息是最新的。
        如果未找到具有此本地名称和名称空间URI的属性，则此方法无效。
        根据[ XML Namespaces ]，如果方法希望没有名称空间，则必须使用值null作为方法的namespaceURI参数。
        参数
        namespaceURI - 要删除的属性的名称空间URI。
        localName - 要删除的属性的本地名称。
        异常
        DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。
        NOT_SUPPORTED_ERR：如果实现不支持功能"XML"并且通过Document公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能引发此问题 。
        从以下版本开始：
        1.4，DOM Level 2

      • getAttributeNodeNS

        Attr getAttributeNodeNS​(String namespaceURI,
                        String localName)
                 throws DOMException
        按本地名称和名称空间URI检索Attr节点。
        根据[ XML Namespaces ]，如果方法希望没有名称空间，则必须使用值null作为方法的namespaceURI参数。
        参数
        namespaceURI - 要检索的属性的名称空间URI。
        localName - 要检索的属性的本地名称。
        结果
        Attr节点具有指定的属性本地名称和名称空间URI或 null如果没有此类属性）。
        异常
        DOMException - NOT_SUPPORTED_ERR：如果实现不支持功能 "XML"并且通过Document公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能 引发此问题 。
        从以下版本开始：
        1.4，DOM Level 2

      • setAttributeNodeNS

        Attr setAttributeNodeNS​(Attr newAttr)
                 throws DOMException
        添加新属性。 如果元素中已存在具有该本地名称和该命名空间URI的属性，则该属性将替换为新属性。 单独替换属性节点无效。
        根据[ XML Namespaces ]，如果方法希望没有名称空间，则必须使用值null作为方法的namespaceURI参数。
        参数
        newAttr - 要添加到属性列表的 Attr节点。
        结果
        如果 newAttr属性使用相同的本地名称和名称空间URI替换现有属性，则返回替换的 Attr节点，否则返回 null 。
        异常
        DOMException - WRONG_DOCUMENT_ERR：如果newAttr是从与创建元素的文档不同的文档创建的，则newAttr 。
        NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。
        INUSE_ATTRIBUTE_ERR：如果newAttr已经是另一个Element对象的属性，则Element 。 DOM用户必须显式克隆Attr节点才能在其他元素中重用它们。
        NOT_SUPPORTED_ERR：如果实现不支持功能"XML"并且通过Document公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能引发此问题 。
        从以下版本开始：
        1.4，DOM Level 2

      • getElementsByTagNameNS

        NodeList getElementsByTagNameNS​(String namespaceURI,
                                String localName)
                         throws DOMException
        返回 NodeList所有后代的 Elements具有给定本地名称和命名空间URI在文档顺序。
        参数
        namespaceURI - 要匹配的元素的名称空间URI。 特殊值“*”匹配所有名称空间。
        localName - 要匹配的元素的本地名称。 特殊值“*”匹配所有本地名称。
        结果
        一个新的 NodeList对象，包含所有匹配的 Elements 。
        异常
        DOMException - NOT_SUPPORTED_ERR：如果实现不支持功能 "XML"并且通过Document公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能 引发此问题 。
        从以下版本开始：
        1.4，DOM Level 2

      • hasAttribute

        boolean hasAttribute​(String name)
        返回 true在此元素上被指定给定名称的属性或具有默认值， false否则。
        参数
        name - 要查找的属性的名称。
        结果
        true如果在此元素上指定了具有给定名称的属性或具有默认值， false 。
        从以下版本开始：
        1.4，DOM Level 2

      • hasAttributeNS

        boolean hasAttributeNS​(String namespaceURI,
                       String localName)
                throws DOMException
        返回true在此元素上被指定或具有默认值，与给定的本地名称和命名空间的属性URI false否则。
        根据[ XML Namespaces ]，如果方法希望没有名称空间，则必须使用值null作为方法的namespaceURI参数。
        参数
        namespaceURI - 要查找的属性的名称空间URI。
        localName - 要查找的属性的本地名称。
        结果
        true如果指定了具有给定本地名称和名称空间URI的属性，或者在此元素上具有默认值， false 。
        异常
        DOMException - NOT_SUPPORTED_ERR：如果实现不支持功能 "XML"并且通过Document公开的语言不支持XML命名空间（例如[ HTML 4.01 ]），则可能 引发此问题 。
        从以下版本开始：
        1.4，DOM Level 2

      • getSchemaTypeInfo

        TypeInfo getSchemaTypeInfo()
        与此元素关联的类型信息。
        从以下版本开始：
        1.5，DOM Level 3

      • setIdAttribute

        void setIdAttribute​(String name,
                    boolean isId)
             throws DOMException
        如果参数isId是true ，则此方法将指定的属性声明为用户确定的ID属性。 这会影响价值Attr.isId和行为Document.getElementById ，但不会改变，可能是在使用中的任何模式，特别是这并没有影响到Attr.schemaTypeInfo指定的Attr节点。 使用值false作为参数isId声明作为用户确定的ID属性的属性。
        要按本地名称和名称空间URI指定属性，请使用setIdAttributeNS方法。
        参数
        name - 属性的名称。
        isId - 属性是否为类型ID。
        异常
        DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。
        NOT_FOUND_ERR：如果指定的节点不是此元素的属性，则引发此异常。
        从以下版本开始：
        1.5，DOM Level 3

      • setIdAttributeNS

        void setIdAttributeNS​(String namespaceURI,
                      String localName,
                      boolean isId)
               throws DOMException
        如果参数isId是true ，则此方法将指定的属性声明为用户确定的ID属性。 这会影响价值Attr.isId和行为Document.getElementById ，但不会改变，可能是在使用中的任何模式，特别是这并没有影响到Attr.schemaTypeInfo指定的Attr节点。 使用参数isId的值false isId声明作为用户确定的ID属性的属性。
        参数
        namespaceURI - 属性的名称空间URI。
        localName - 属性的本地名称。
        isId - 属性是否为类型ID。
        异常
        DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。
        NOT_FOUND_ERR：如果指定的节点不是此元素的属性，则引发此异常。
        从以下版本开始：
        1.5，DOM Level 3

      • setIdAttributeNode

        void setIdAttributeNode​(Attr idAttr,
                        boolean isId)
                 throws DOMException
        如果参数isId为true ，则此方法将指定的属性声明为用户确定的ID属性。 这会影响价值Attr.isId和行为Document.getElementById ，但不会改变，可能是在使用中的任何模式，特别是这并没有影响到Attr.schemaTypeInfo指定的Attr节点。 使用参数isId的值false isId声明作为用户确定的ID属性的属性。
        参数
        idAttr - 属性节点。
        isId - 属性是否为类型ID。
        异常
        DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发此异常。
        NOT_FOUND_ERR：如果指定的节点不是此元素的属性，则引发此异常。
        从以下版本开始：
        1.5，DOM Level 3