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

Interface Element

    • 方法详细信息

      • getTagName

        String getTagName()
        元素的名称。 如果Node.localNamenull不同,则此属性是限定名称。 例如,在:
          <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节点以及任何TextEntityReference节点,构建相应的子树,并使用setAttributeNode将其指定为属性的值。
        要使用限定名称和名称空间URI设置属性,请使用setAttributeNS方法。
        参数
        name - 要创建或更改的属性的名称。
        value - 以字符串形式设置的值。
        异常
        DOMException - INVALID_CHARACTER_ERR:根据Document.xmlVersion属性中指定的使用的XML版本,如果指定的名称不是XML名称,则Document.xmlVersionDocument.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节点以及任何TextEntityReference节点,构建相应的子树,并使用setAttributeNodeNSsetAttributeNode将其指定为属性的值。
        根据[ 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有前缀而namespaceURInull ,如果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
        如果参数isIdtrue ,则此方法将指定的属性声明为用户确定的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
        如果参数isIdtrue ,则此方法将指定的属性声明为用户确定的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
        如果参数isIdtrue ,则此方法将指定的属性声明为用户确定的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