public interface Element extends Node
Element
интерфейс представляет элемент в HTML или XML-документе. У элементов могут быть атрибуты, связанные с ними; начиная с Element
интерфейс наследовался от Node
, обобщение Node
атрибут интерфейса attributes
может использоваться, чтобы получить набор всех атрибутов для элемента. Есть методы на Element
интерфейс, чтобы получить любого Attr
возразите по имени или значение атрибута по имени. В XML, где значение атрибута может содержать ссылки на сущность, Attr
объект должен быть получен, чтобы исследовать возможно довольно сложное поддерево, представляющее значение атрибута. С другой стороны, в HTML, где у всех атрибутов есть простые строковые значения, методы, чтобы непосредственно получить доступ к значению атрибута могут безопасно использоваться в качестве удобства. Отметьте: В ДОМЕ Левеле 2, метод normalize
наследован от 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
Модификатор и Тип | Метод и Описание |
---|---|
Строка |
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. |
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
String getTagName()
Node.localName
отличается от null
, этот атрибут является полностью определенным именем. Например, в: <elementExample id="demo"> ... </elementExample> ,
tagName
имеет значение "elementExample"
. Отметьте, что это - сохранение случая в XML, как все операции ДОМА. HTML ДОМ возвращается tagName
из элемента HTML в канонической форме верхнего регистра, независимо от случая в исходном документе HTML.String getAttribute(String name)
name
- Имя атрибута, чтобы получить.Attr
оцените как строка, или пустая строка, если у того атрибута нет указанного или значения по умолчанию.void setAttribute(String name, String value) throws DOMException
Attr
узел плюс любой Text
и EntityReference
узлы, создайте соответствующее поддерево, и использование setAttributeNode
присваивать это как значение атрибута. setAttributeNS
метод.name
- Имя атрибута, чтобы создать или измениться.value
- Значение, чтобы установить в строковой форме.DOMException
- INVALID_CHARACTER_ERR: Повышенный, если указанное имя не является именем XML согласно версии XML в использовании, определенном в Document.xmlVersion
атрибут. void removeAttribute(String name) throws DOMException
Document.normalizeDocument()
гарантировать эту информацию актуально. removeAttributeNS
метод.name
- Имя атрибута, чтобы удалить.DOMException
- NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения.Attr getAttributeNode(String name)
getAttributeNodeNS
метод.name
- Имя (nodeName
) из атрибута, чтобы получить.Attr
узел с указанным именем ( nodeName
) или null
если нет такого атрибута.Attr setAttributeNode(Attr newAttr) throws DOMException
nodeName
) уже присутствует в элементе, он заменяется новым. Замена узла атрибута отдельно не имеет никакого эффекта. setAttributeNodeNS
метод.newAttr
- Attr
узел, чтобы добавить к списку атрибутов.newAttr
припишите заменяет существующий атрибут, замененный Attr
узел возвращается, иначе null
возвращается.DOMException
- WRONG_DOCUMENT_ERR: Повышенный, если newAttr
создавался из различного документа чем тот, который создал элемент. newAttr
уже атрибут другого Element
объект. Пользователь ДОМА должен явно клонироваться Attr
узлы, чтобы снова использовать их в других элементах.Attr removeAttributeNode(Attr oldAttr) throws DOMException
Attr
узел определяется в DTD, новый узел сразу появляется со значением по умолчанию так же как соответствующим URI пространства имен, локальным именем, и префиксом когда применимый. Реализация может обработать значения по умолчанию из других схем так же, но приложения должны использовать Document.normalizeDocument()
гарантировать эту информацию актуально.oldAttr
- Attr
узел, чтобы удалить из списка атрибутов.Attr
узел, который был удален.DOMException
- NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения. oldAttr
не атрибут элемента.NodeList getElementsByTagName(String name)
NodeList
из всего потомка Elements
с данным именем тега, в порядке документа.name
- Имя тега, чтобы соответствовать на. Специальное значение "*" соответствует все теги.Element
узлы.String getAttributeNS(String namespaceURI, String localName) throws DOMException
null
как namespaceURI
параметр для методов, если они хотят не иметь никакого пространства имен.namespaceURI
- URI пространства имен атрибута, чтобы получить.localName
- Локальное имя атрибута, чтобы получить.Attr
оцените как строка, или пустая строка, если у того атрибута нет указанного или значения по умолчанию.DOMException
- NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML"
и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как void setAttributeNS(String namespaceURI, String qualifiedName, String value) throws DOMException
qualifiedName
, и его значение изменяется, чтобы быть value
параметр. Это значение является простой строкой; это не анализируется, поскольку это устанавливается. Таким образом, любая разметка (такая как синтаксис, который будет распознан как ссылка на сущность), обрабатывается как обычный текст, и должна быть соответственно оставлена реализацией, когда это выписывается. Чтобы присвоить значение атрибута, которое содержит ссылки на сущность, пользователь должен создать Attr
узел плюс любой Text
и EntityReference
узлы, создайте соответствующее поддерево, и использование setAttributeNodeNS
или setAttributeNode
присваивать это как значение атрибута. null
как namespaceURI
параметр для методов, если они хотят не иметь никакого пространства имен.namespaceURI
- URI пространства имен атрибута, чтобы создать или измениться.qualifiedName
- Полностью определенное имя атрибута, чтобы создать или измениться.value
- Значение, чтобы установить в строковой форме.DOMException
- INVALID_CHARACTER_ERR: Повышенный, если указанное полностью определенное имя не является именем XML согласно версии XML в использовании, определенном в Document.xmlVersion
атрибут. qualifiedName
уродливо на Пространства имен в спецификации XML, если qualifiedName
имеет префикс и namespaceURI
null
, если qualifiedName
имеет префикс, который является "xml" и namespaceURI
отличается отqualifiedName
или его префикс является "xmlns" и namespaceURI
отличается от "namespaceURI
"qualifiedName
ни его префикс является "xmlns". "XML"
и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как void removeAttributeNS(String namespaceURI, String localName) throws DOMException
Document.normalizeDocument()
гарантировать эту информацию актуально. null
как namespaceURI
параметр для методов, если они хотят не иметь никакого пространства имен.namespaceURI
- URI пространства имен атрибута, чтобы удалить.localName
- Локальное имя атрибута, чтобы удалить.DOMException
- NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения. "XML"
и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как Attr getAttributeNodeNS(String namespaceURI, String localName) throws DOMException
Attr
узел локальным именем и URI пространства имен. null
как namespaceURI
параметр для методов, если они хотят не иметь никакого пространства имен.namespaceURI
- URI пространства имен атрибута, чтобы получить.localName
- Локальное имя атрибута, чтобы получить.Attr
узел с указанным атрибутом локальное имя и URI пространства имен или null
если нет такого атрибута.DOMException
- NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML"
и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как Attr setAttributeNodeNS(Attr newAttr) throws DOMException
null
как namespaceURI
параметр для методов, если они хотят не иметь никакого пространства имен.newAttr
- Attr
узел, чтобы добавить к списку атрибутов.newAttr
припишите заменяет существующий атрибут тем же самым локальным именем и URI пространства имен, замененным Attr
узел возвращается, иначе null
возвращается.DOMException
- WRONG_DOCUMENT_ERR: Повышенный, если newAttr
создавался из различного документа чем тот, который создал элемент. newAttr
уже атрибут другого Element
объект. Пользователь ДОМА должен явно клонироваться Attr
узлы, чтобы снова использовать их в других элементах. "XML"
и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как NodeList getElementsByTagNameNS(String namespaceURI, String localName) throws DOMException
NodeList
из всего потомка Elements
с данным локальным именем и URI пространства имен в порядке документа.namespaceURI
- URI пространства имен элементов, чтобы соответствовать на. Специальное значение "*" соответствует все пространства имен.localName
- Локальное имя элементов, чтобы соответствовать на. Специальное значение "*" соответствует все локальные имена.NodeList
объект, содержащий все соответствующее Elements
.DOMException
- NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML"
и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как boolean hasAttribute(String name)
true
когда атрибут с именем определяется на этом элементе или имеет значение по умолчанию, false
иначе.name
- Имя атрибута, чтобы искать.true
если атрибут с именем определяется на этом элементе или имеет значение по умолчанию, false
иначе.boolean hasAttributeNS(String namespaceURI, String localName) throws DOMException
true
когда атрибут с данным локальным именем и URI пространства имен определяется на этом элементе или имеет значение по умолчанию, false
иначе. null
как namespaceURI
параметр для методов, если они хотят не иметь никакого пространства имен.namespaceURI
- URI пространства имен атрибута, чтобы искать.localName
- Локальное имя атрибута, чтобы искать.true
если атрибут с данным локальным именем и URI пространства имен определяется или имеет значение по умолчанию на этом элементе, false
иначе.DOMException
- NOT_SUPPORTED_ERR: Может быть повышен, если реализация не поддерживает функцию "XML"
и язык, представленный через Документ, не поддерживает XML Пространства имен (такие как TypeInfo getSchemaTypeInfo()
void setIdAttribute(String name, boolean isId) throws DOMException
isId
true
, этот метод объявляет, что указанный атрибут определенный пользователем атрибут ID. Это влияет на значение Attr.isId
и поведение Document.getElementById
, но не изменяет схемы, которая может использоваться, в особенности это не влияет Attr.schemaTypeInfo
из указанного Attr
узел. Используйте значение false
для параметра isId
необъявить атрибут для того, чтобы быть определенным пользователем атрибутом ID. setIdAttributeNS
метод.name
- Имя атрибута.isId
- Является ли атрибут идентификатора типа.DOMException
- NO_MODIFICATION_ALLOWED_ERR: Повышенный, если этот узел только для чтения. 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: Повышенный, если этот узел только для чтения. 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: Повышенный, если этот узел только для чтения.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92