Элемент (Платформа Java SE 7)

Все Суперинтерфейсы:

Узел

Все Известные Подынтерфейсы:

Деталь, 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, где у всех атрибутов есть простые строковые значения, методы, чтобы непосредственно получить доступ к значению атрибута могут безопасно использоваться в качестве удобства.
Отметьте: В ДОМЕ Левеле 2, метод normalize наследован от Node взаимодействуйте через интерфейс, куда это было перемещено.
См. также Объектную модель документа (ДОМ) Спецификация Ядра Уровня 3.

Полевая Сводка
- Поля, наследованные от интерфейса org.w3c.dom. Узел
  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

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Строка`	`getAttribute(String name)` Получает значение атрибута по имени.
`Attr`	`getAttributeNode(String name)` Получает узел атрибута по имени.
`Attr`	`getAttributeNodeNS(String namespaceURI, String localName)` Получает `Attr` узел локальным именем и URI пространства имен.
`Строка`	`getAttributeNS(String namespaceURI, String localName)` Получает значение атрибута локальным именем и URI пространства имен.
`NodeList`	`getElementsByTagName(String name)` Возвраты a `NodeList` из всего потомка `Elements` с данным именем тега, в порядке документа.
`NodeList`	`getElementsByTagNameNS(String namespaceURI, String localName)` Возвраты a `NodeList` из всего потомка `Elements` с данным локальным именем и URI пространства имен в порядке документа.
`TypeInfo`	`getSchemaTypeInfo()` Информация о типе связалась с этим элементом.
`Строка`	`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.

Методы, наследованные от интерфейса org.w3c.dom. Узел
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="demo"> ...
 </elementExample> , 
```
    tagName имеет значение "elementExample". Отметьте, что это - сохранение случая в XML, как все операции ДОМА. HTML ДОМ возвращается tagName из элемента HTML в канонической прописной форме, независимо от случая в исходном документе HTML.
  - getAttribute
```
String getAttribute(String name)
```
    Получает значение атрибута по имени.
    
    Параметры:
    name - Имя атрибута, чтобы получить.
    
    Возвраты:
    Attr оцените как строка, или пустая строка, если у того атрибута нет указанного или значения по умолчанию.
  - setAttribute
```
void setAttribute(String name,
                String value)
                  throws DOMException
```
    Добавляет новый атрибут. Если атрибут с тем именем уже присутствует в элементе, его значение изменяется, чтобы быть тем из параметра, передаваемого по значению. Это значение является простой строкой; это не анализируется, поскольку это устанавливается. Таким образом, любая разметка (такая как синтаксис, который будет распознан как ссылка на сущность), обрабатывается как обычный текст, и должна быть соответственно оставлена реализацией, когда это выписывается. Чтобы присвоить значение атрибута, которое содержит ссылки на сущность, пользователь должен создать Attr узел плюс любой Text и EntityReference узлы, создайте соответствующее поддерево, и использование setAttributeNode присваивать это как значение атрибута.
    Чтобы установить атрибут с полностью определенным именем и URI пространства имен, используйте setAttributeNS метод.
    
    Параметры:
    name - Имя атрибута, чтобы создать или измениться.
    value - Значение, чтобы установить в строковой форме.
    
    Броски:
    
    DOMException - INVALID_CHARACTER_ERR: Повышенный, если указанное имя не является именем XML согласно версии XML в использовании, определенном в 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 создавался из различного документа чем тот, который создал элемент.
    NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.
    INUSE_ATTRIBUTE_ERR: Повышенный, если newAttr уже атрибут другого Element объект. Пользователь ДОМА должен явно клонироваться 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)
```
    Возвраты a NodeList из всего потомка Elements с данным именем тега, в порядке документа.
    
    Параметры:
    name - Имя тега, чтобы соответствовать на. Специальное значение "*" соответствует все теги.
    
    Возвраты:
    Список соответствия Element узлы.
  - getAttributeNS
```
String getAttributeNS(String namespaceURI,
                    String localName)
                      throws DOMException
```
    Получает значение атрибута локальным именем и URI пространства имен.
    На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    namespaceURI - URI пространства имен атрибута, чтобы получить.
    localName - Локальное имя атрибута, чтобы получить.
    
    Возвраты:
    Attr оцените как строка, или пустая строка, если у того атрибута нет указанного или значения по умолчанию.
    
    Броски:
    
    DOMException - NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML" и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - setAttributeNS
```
void setAttributeNS(String namespaceURI,
                  String qualifiedName,
                  String value)
                    throws DOMException
```
    Добавляет новый атрибут. Если атрибут с тем же самым локальным именем и URI пространства имен уже присутствует на элементе, его префикс изменяется, чтобы быть префиксной частью qualifiedName, и его значение изменяется, чтобы быть value параметр. Это значение является простой строкой; это не анализируется, поскольку это устанавливается. Таким образом, любая разметка (такая как синтаксис, который будет распознан как ссылка на сущность), обрабатывается как обычный текст, и должна быть соответственно оставлена реализацией, когда это выписывается. Чтобы присвоить значение атрибута, которое содержит ссылки на сущность, пользователь должен создать Attr узел плюс любой Text и EntityReference узлы, создайте соответствующее поддерево, и использование setAttributeNodeNS или setAttributeNode присваивать это как значение атрибута.
    На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    namespaceURI - URI пространства имен атрибута, чтобы создать или измениться.
    qualifiedName - Полностью определенное имя атрибута, чтобы создать или измениться.
    value - Значение, чтобы установить в строковой форме.
    
    Броски:
    
    DOMException - INVALID_CHARACTER_ERR: Повышенный, если указанное полностью определенное имя не является именем XML согласно версии 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" и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - removeAttributeNS
```
void removeAttributeNS(String namespaceURI,
                     String localName)
                       throws DOMException
```
    Удаляет атрибут локальным именем и URI пространства имен. Если значение по умолчанию для удаленного атрибута определяется в DTD, новый атрибут сразу появляется со значением по умолчанию так же как соответствующим URI пространства имен, локальным именем, и префиксом когда применимый. Реализация может обработать значения по умолчанию из других схем так же, но приложения должны использовать Document.normalizeDocument() гарантировать эту информацию актуально.
    Если никакой атрибут с этим локальным именем и URI пространства имен не находится, этот метод не имеет никакого эффекта.
    На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    namespaceURI - URI пространства имен атрибута, чтобы удалить.
    localName - Локальное имя атрибута, чтобы удалить.
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.
    NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML" и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - getAttributeNodeNS
```
Attr getAttributeNodeNS(String namespaceURI,
                      String localName)
                        throws DOMException
```
    Получает Attr узел локальным именем и URI пространства имен.
    На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    namespaceURI - URI пространства имен атрибута, чтобы получить.
    localName - Локальное имя атрибута, чтобы получить.
    
    Возвраты:
    Attr узел с указанным атрибутом локальное имя и URI пространства имен или null если нет такого атрибута.
    
    Броски:
    
    DOMException - NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML" и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - setAttributeNodeNS
```
Attr setAttributeNodeNS(Attr newAttr)
                        throws DOMException
```
    Добавляет новый атрибут. Если атрибут с тем локальным именем и тем URI пространства имен уже присутствует в элементе, это заменяется новым. Замена узла атрибута отдельно не имеет никакого эффекта.
    На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    newAttr - Attr узел, чтобы добавить к списку атрибутов.
    
    Возвраты:
    Если newAttr припишите заменяет существующий атрибут тем же самым локальным именем и URI пространства имен, замененным Attr узел возвращается, иначе null возвращается.
    
    Броски:
    
    DOMException - WRONG_DOCUMENT_ERR: Повышенный, если newAttr создавался из различного документа чем тот, который создал элемент.
    NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.
    INUSE_ATTRIBUTE_ERR: Повышенный, если newAttr уже атрибут другого Element объект. Пользователь ДОМА должен явно клонироваться Attr узлы, чтобы снова использовать их в других элементах.
    NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML" и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - getElementsByTagNameNS
```
NodeList getElementsByTagNameNS(String namespaceURI,
                              String localName)
                                throws DOMException
```
    Возвраты a NodeList из всего потомка Elements с данным локальным именем и URI пространства имен в порядке документа.
    
    Параметры:
    namespaceURI - URI пространства имен элементов, чтобы соответствовать на. Специальное значение "*" соответствует все пространства имен.
    localName - Локальное имя элементов, чтобы соответствовать на. Специальное значение "*" соответствует все локальные имена.
    
    Возвраты:
    Новое NodeList объект, содержащий все соответствующее Elements.
    
    Броски:
    
    DOMException - NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML" и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - hasAttribute
```
boolean hasAttribute(String name)
```
    Возвраты true когда атрибут с именем определяется на этом элементе или имеет значение по умолчанию, false иначе.
    
    Параметры:
    name - Имя атрибута, чтобы искать.
    
    Возвраты:
    true если атрибут с именем определяется на этом элементе или имеет значение по умолчанию, false иначе.
    С тех пор:
    
    ДОМ Левель 2
  - hasAttributeNS
```
boolean hasAttributeNS(String namespaceURI,
                     String localName)
                       throws DOMException
```
    Возвраты true когда атрибут с данным локальным именем и URI пространства имен определяется на этом элементе или имеет значение по умолчанию, false иначе.
    На [XML Пространства имен], приложения должны использовать значение null как namespaceURI параметр для методов, если они хотят не иметь никакого пространства имен.
    
    Параметры:
    namespaceURI - URI пространства имен атрибута, чтобы искать.
    localName - Локальное имя атрибута, чтобы искать.
    
    Возвраты:
    true если атрибут с данным локальным именем и URI пространства имен определяется или имеет значение по умолчанию на этом элементе, false иначе.
    
    Броски:
    
    DOMException - NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML" и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как [HTML 4.01]).
    С тех пор:
    
    ДОМ Левель 2
  - getSchemaTypeInfo
```
TypeInfo getSchemaTypeInfo()
```
    Информация о типе связалась с этим элементом.
    
    С тех пор:
    
    ДОМ Левель 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 - Является ли атрибут идентификатора типа.
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.
    NOT_FOUND_ERR: Повышенный, если указанный узел не является атрибутом этого элемента.
    С тех пор:
    
    ДОМ Левель 3
  - setIdAttributeNS
```
void setIdAttributeNS(String namespaceURI,
                    String localName,
                    boolean isId)
                      throws DOMException
```
    Если параметр isId true, этот метод объявляет, что указанный атрибут определенный пользователем атрибут ID. Это влияет на значение Attr.isId и поведение Document.getElementById, но не изменяет схемы, которая может использоваться, в особенности это не влияет Attr.schemaTypeInfo из указанного Attr узел. Используйте значение false для параметра isId необъявить атрибут для того, чтобы быть определенным пользователем атрибутом ID.
    
    Параметры:
    namespaceURI - URI пространства имен атрибута.
    localName - Локальное имя атрибута.
    isId - Является ли атрибут идентификатора типа.
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.
    NOT_FOUND_ERR: Повышенный, если указанный узел не является атрибутом этого элемента.
    С тех пор:
    
    ДОМ Левель 3
  - setIdAttributeNode
```
void setIdAttributeNode(Attr idAttr,
                      boolean isId)
                        throws DOMException
```
    Если параметр isId true, этот метод объявляет, что указанный атрибут определенный пользователем атрибут ID. Это влияет на значение Attr.isId и поведение Document.getElementById, но не изменяет схемы, которая может использоваться, в особенности это не влияет Attr.schemaTypeInfo из указанного Attr узел. Используйте значение false для параметра isId необъявить атрибут для того, чтобы быть определенным пользователем атрибутом ID.
    
    Параметры:
    idAttr - Узел атрибута.
    isId - Является ли атрибут идентификатора типа.
    
    Броски:
    
    DOMException - NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.
    NOT_FOUND_ERR: Повышенный, если указанный узел не является атрибутом этого элемента.
    С тех пор:
    
    ДОМ Левель 3

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный Элемент

Полевая Сводка

Поля, наследованные от интерфейса org.w3c.dom. Узел

Сводка метода

Методы, наследованные от интерфейса org.w3c.dom. Узел

Деталь метода

getTagName

getAttribute

setAttribute

removeAttribute

getAttributeNode

setAttributeNode

removeAttributeNode

getElementsByTagName

getAttributeNS

setAttributeNS

removeAttributeNS

getAttributeNodeNS

setAttributeNodeNS

getElementsByTagNameNS

hasAttribute

hasAttributeNS

getSchemaTypeInfo

setIdAttribute

setIdAttributeNS

setIdAttributeNode