Интерфейс Element
- Все суперинтерфейсы:
Node
- Все известные подинтерфейсы:
HTMLAnchorElement, HTMLAppletElement, HTMLAreaElement, HTMLBaseElement, HTMLBaseFontElement, HTMLBodyElement, HTMLBRElement, HTMLButtonElement, HTMLDirectoryElement, HTMLDivElement, HTMLDListElement, HTMLElement, HTMLFieldSetElement, HTMLFontElement, HTMLFormElement, HTMLFrameElement, HTMLFrameSetElement, HTMLHeadElement, HTMLHeadingElement, HTMLHRElement, HTMLHtmlElement, HTMLIFrameElement, HTMLImageElement, HTMLInputElement, HTMLIsIndexElement, HTMLLabelElement, HTMLLegendElement, HTMLLIElement, HTMLLinkElement, HTMLMapElement, HTMLMenuElement, HTMLMetaElement, HTMLModElement, HTMLObjectElement, HTMLOListElement, HTMLOptGroupElement, HTMLOptionElement, HTMLParagraphElement, HTMLParamElement, HTMLPreElement, HTMLQuoteElement, HTMLScriptElement, HTMLSelectElement, HTMLStyleElement, HTMLTableCaptionElement, HTMLTableCellElement, HTMLTableColElement, HTMLTableElement, HTMLTableRowElement, HTMLTableSectionElement, HTMLTextAreaElement, HTMLTitleElement, HTMLUListElement
- Все известные реализующие классы:
IIOMetadataNode
public interface Element extends Node
Интерфейс
Element представляет элемент в документе HTML или XML. С элементами могут быть связаны атрибуты; поскольку интерфейс Element наследуется от Node, для получения набора всех атрибутов элемента можно использовать универсальный атрибут интерфейса Node attributes. В интерфейсе Element имеются методы для получения объекта Attr по имени или значения атрибута по имени. В XML, где значение атрибута может содержать ссылки на сущности, для изучения потенциально довольно сложного поддерева, представляющего значение атрибута, следует получить объект Attr. В HTML, напротив, где все атрибуты имеют простые строковые значения, для удобства можно безопасно использовать методы прямого доступа к значению атрибута. Примечание: В DOM Level 2 метод normalize наследуется от интерфейса Node, куда он был перенесён.
См. также Спецификацию объектной модели документа (DOM) Core Level 3.
- С версии:
- 1.4, DOM Level 2
Краткое описание полей
Поля, объявленные в интерфейсе 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 | Модификатор и тип | Поле | Описание |
|---|---|---|
static final short |
ATTRIBUTE_NODE |
Узел является Attr. |
static final short |
CDATA_SECTION_NODE |
Узел является CDATASection. |
static final short |
COMMENT_NODE |
Узел является Comment. |
static final short |
DOCUMENT_FRAGMENT_NODE |
Узел является DocumentFragment. |
static final short |
DOCUMENT_NODE |
Узел является Document. |
static final short |
DOCUMENT_POSITION_CONTAINED_BY |
Узел содержится в узле-ссылке. |
static final short |
DOCUMENT_POSITION_CONTAINS |
Узел содержит узел-ссылку. |
static final short |
DOCUMENT_POSITION_DISCONNECTED |
Узлы не связаны. |
static final short |
DOCUMENT_POSITION_FOLLOWING |
Узел следует за узлом-ссылкой. |
static final short |
DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC |
Определение того, какой узел предшествует, а какой следует, зависит от реализации. |
static final short |
DOCUMENT_POSITION_PRECEDING |
Второй узел предшествует узлу-ссылке. |
static final short |
DOCUMENT_TYPE_NODE |
Узел является DocumentType. |
static final short |
ELEMENT_NODE |
Узел является Element. |
static final short |
ENTITY_NODE |
Узел является Entity. |
static final short |
ENTITY_REFERENCE_NODE |
Узел является EntityReference. |
static final short |
NOTATION_NODE |
Узел является Notation. |
static final short |
PROCESSING_INSTRUCTION_NODE |
Узел является ProcessingInstruction. |
static final short |
TEXT_NODE |
Узел является узлом Text. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
String |
getAttribute |
Получает значение атрибута по имени. |
Attr |
getAttributeNode |
Получает узел атрибута по имени. |
Attr |
getAttributeNodeNS |
Получает узел Attr по локальному имени и URI пространства имён. |
String |
getAttributeNS |
Получает значение атрибута по локальному имени и URI пространства имён. |
NodeList |
getElementsByTagName |
Возвращает NodeList всех потомков Elements с заданным именем тега в порядке документа. |
NodeList |
getElementsByTagNameNS |
Возвращает NodeList всех потомков Elements с заданным локальным именем и URI пространства имён в порядке документа. |
TypeInfo |
getSchemaTypeInfo() |
Информация о типе, связанная с этим элементом. |
String |
getTagName() |
Имя элемента. |
boolean |
hasAttribute |
Возвращает true, если для этого элемента задан атрибут с указанным именем или у него есть значение по умолчанию, и false в противном случае. |
boolean |
hasAttributeNS |
Возвращает true, если для этого элемента задан атрибут с указанным локальным именем и URI пространства имён или у него есть значение по умолчанию, и false в противном случае. |
void |
removeAttribute |
Удаляет атрибут по имени. |
Attr |
removeAttributeNode |
Удаляет указанный узел атрибута. |
void |
removeAttributeNS |
Удаляет атрибут по локальному имени и URI пространства имён. |
void |
setAttribute |
Добавляет новый атрибут. |
Attr |
setAttributeNode |
Добавляет новый узел атрибута. |
Attr |
setAttributeNodeNS |
Добавляет новый атрибут. |
void |
setAttributeNS |
Добавляет новый атрибут. |
void |
setIdAttribute |
Если параметр isId равен true, этот метод объявляет указанный атрибут идентификаторным атрибутом, определяемым пользователем. |
void |
setIdAttributeNode |
Если параметр isId равен true, этот метод объявляет указанный атрибут идентификаторным атрибутом, определяемым пользователем. |
void |
setIdAttributeNS |
Если параметр isId равен true, этот метод объявляет указанный атрибут идентификаторным атрибутом, определяемым пользователем. |
Методы, объявленные в интерфейсе 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 | Модификатор и тип | Метод | Описание |
|---|---|---|
Node |
appendChild |
Добавляет узел newChild в конец списка дочерних узлов этого узла. |
Node |
cloneNode |
Возвращает копию этого узла, то есть служит универсальным конструктором копирования для узлов. |
short |
compareDocumentPosition |
Сравнивает узел-ссылку, то есть узел, для которого вызывается этот метод, с другим узлом, переданным в качестве параметра, по их положению в документе и в соответствии с порядком документа. |
NamedNodeMap |
getAttributes() |
NamedNodeMap, содержащий атрибуты этого узла (если он является Element), или null в противном случае. |
String |
getBaseURI() |
Абсолютный базовый URI этого узла или null, если реализации не удалось получить абсолютный URI. |
NodeList |
getChildNodes() |
NodeList, содержащий все дочерние узлы этого узла. |
Object |
getFeature |
Этот метод возвращает специализированный объект, реализующий специализированные API указанной функциональности и версии, как определено в . |
Node |
getFirstChild() |
Первый дочерний узел этого узла. |
Node |
getLastChild() |
Последний дочерний узел этого узла. |
String |
getLocalName() |
Возвращает локальную часть квалифицированного имени этого узла. |
String |
getNamespaceURI() |
URI пространства имён этого узла или null, если он не указан (см. ). |
Node |
getNextSibling() |
Узел, непосредственно следующий за этим узлом. |
String |
getNodeName() |
Имя этого узла в зависимости от его типа; см. таблицу выше. |
short |
getNodeType() |
Код, представляющий тип базового объекта, как определено выше. |
String |
getNodeValue() |
Значение этого узла в зависимости от его типа; см. таблицу выше. |
Document |
getOwnerDocument() |
Объект Document, связанный с этим узлом. |
Node |
getParentNode() |
Родительский узел этого узла. |
String |
getPrefix() |
Префикс пространства имён этого узла или null, если он не указан. |
Node |
getPreviousSibling() |
Узел, непосредственно предшествующий этому узлу. |
String |
getTextContent() |
Этот атрибут возвращает текстовое содержимое этого узла и его потомков. |
Object |
getUserData |
Получает объект, связанный с ключом в этом узле. |
boolean |
hasAttributes() |
Возвращает, есть ли у этого узла атрибуты (если он является элементом). |
boolean |
hasChildNodes() |
Возвращает, есть ли у этого узла дочерние узлы. |
Node |
insertBefore |
Вставляет узел newChild перед существующим дочерним узлом refChild. |
boolean |
isDefaultNamespace |
Этот метод проверяет, является ли указанный namespaceURI пространством имён по умолчанию. |
boolean |
isEqualNode |
Проверяет, равны ли два узла. |
boolean |
isSameNode |
Возвращает, является ли этот узел тем же узлом, что и указанный. |
boolean |
isSupported |
Проверяет, реализует ли DOM-реализация определённую функциональность и поддерживается ли эта функциональность данным узлом, как указано в . |
String |
lookupNamespaceURI |
Ищет URI пространства имён, связанный с указанным префиксом, начиная с этого узла. |
String |
lookupPrefix |
Ищет префикс, связанный с указанным URI пространства имён, начиная с этого узла. |
void |
normalize() |
Приводит все узлы Text на всей глубине поддерева под этим Node, включая узлы атрибутов, к «нормальной» форме, в которой узлы Text разделяются только структурными элементами (например, элементами, комментариями, инструкциями обработки, секциями CDATA и ссылками на сущности); то есть соседних узлов Text и пустых узлов Text не остаётся. |
Node |
removeChild |
Удаляет дочерний узел, указанный параметром oldChild, из списка дочерних узлов и возвращает его. |
Node |
replaceChild |
Заменяет дочерний узел oldChild на newChild в списке дочерних узлов и возвращает узел oldChild. |
void |
setNodeValue |
Значение этого узла в зависимости от его типа; см. таблицу выше. |
void |
setPrefix |
Префикс пространства имён этого узла или null, если он не указан. |
void |
setTextContent |
Этот атрибут возвращает текстовое содержимое этого узла и его потомков. |
Object |
setUserData |
Связывает объект с ключом в этом узле. |
Подробное описание методов
getTagName
String getTagName()
Имя элемента. Если
Node.localName отличается от null, этот атрибут является квалифицированным именем. Например, в: <elementExample id="demo"> ... </elementExample> ,
tagName имеет значение "elementExample". Обратите внимание, что в XML сохраняется регистр, как и во всех операциях DOM. HTML DOM возвращает tagName элемента HTML в канонической форме верхнего регистра независимо от регистра в исходном документе HTML.getAttribute
String getAttribute(String name)
Получает значение атрибута по имени.
- Параметры:
-
name— имя атрибута для получения. - Возвращает:
- Значение
Attrв виде строки или пустую строку, если для этого атрибута не задано значение и отсутствует значение по умолчанию.
setAttribute
void setAttribute(String name, String value) throws DOMException
Добавляет новый атрибут. Если элемент уже содержит атрибут с таким именем, его значение заменяется значением параметра value. Это значение представляет собой простую строку; при его задании оно не анализируется. Поэтому любая разметка (например, синтаксис, распознаваемый как ссылка на сущность) рассматривается как обычный текст, и при записи должна быть соответствующим образом экранирована реализацией. Чтобы присвоить атрибуту значение, содержащее ссылки на сущности, пользователь должен создать узел
Чтобы задать атрибут с квалифицированным именем и URI пространства имен, используйте метод
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 пространства имен, локальным именем и префиксом, если применимо. Реализация может аналогичным образом обрабатывать значения по умолчанию из других схем, однако приложениям следует использовать
Если атрибут с таким именем не найден, этот метод ничего не делает.
Чтобы удалить атрибут по локальному имени и URI пространства имен, используйте метод
Document.normalizeDocument(), чтобы гарантировать актуальность этой информации. Если атрибут с таким именем не найден, этот метод ничего не делает.
Чтобы удалить атрибут по локальному имени и URI пространства имен, используйте метод
removeAttributeNS.- Параметры:
-
name— имя удаляемого атрибута. - Выбрасывает:
-
DOMException— NO_MODIFICATION_ALLOWED_ERR: возникает, если этот узел доступен только для чтения.
getAttributeNode
Attr getAttributeNode(String name)
Получает узел атрибута по имени.
Чтобы получить узел атрибута по квалифицированному имени и URI пространства имен, используйте метод
Чтобы получить узел атрибута по квалифицированному имени и URI пространства имен, используйте метод
getAttributeNodeNS.- Параметры:
-
name— имя (nodeName) атрибута для получения. - Возвращает:
- Узел
Attrс указанным именем (nodeName) илиnull, если такого атрибута нет.
setAttributeNode
Attr setAttributeNode(Attr newAttr) throws DOMException
Добавляет новый узел атрибута. Если элемент уже содержит атрибут с таким именем (
Чтобы добавить новый узел атрибута с квалифицированным именем и URI пространства имен, используйте метод
nodeName), он заменяется новым. Замена узла атрибута им самим ничего не меняет. Чтобы добавить новый узел атрибута с квалифицированным именем и URI пространства имен, используйте метод
setAttributeNodeNS.- Параметры:
-
newAttr— узелAttrдля добавления в список атрибутов. - Возвращает:
- Если атрибут
newAttrзаменяет существующий атрибут, возвращается заменённый узелAttr, в противном случае возвращаетсяnull. - Выбрасывает:
-
DOMException— WRONG_DOCUMENT_ERR: возникает, еслиnewAttrбыл создан другим документом, а не тем, который создал элемент.
NO_MODIFICATION_ALLOWED_ERR: возникает, если этот узел доступен только для чтения.
INUSE_ATTRIBUTE_ERR: возникает, еслиnewAttrуже является атрибутом другого объектаElement. Для повторного использования узловAttrв других элементах пользователь DOM должен явно клонировать их.
removeAttributeNode
Attr removeAttributeNode(Attr oldAttr) throws DOMException
Удаляет указанный узел атрибута. Если в DTD задано значение по умолчанию для удалённого узла
Attr, сразу появляется новый узел со значением по умолчанию, а также соответствующими 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 пространства имен.
Согласно [Пространства имен XML], приложения должны использовать значение
Согласно [Пространства имен XML], приложения должны использовать значение
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 пространства имен, его префикс заменяется частью префикса из
Согласно [Пространства имен XML], приложения должны использовать значение
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", а язык, доступный через Document, не поддерживает пространства имен XML (например, [HTML 4.01]). - Начиная с версии:
- 1.4, DOM Level 2
removeAttributeNS
void removeAttributeNS(String namespaceURI, String localName) throws DOMException
Удаляет атрибут по локальному имени и URI пространства имен. Если в DTD задано значение по умолчанию для удаляемого атрибута, сразу появляется новый атрибут со значением по умолчанию, а также соответствующими URI пространства имен, локальным именем и префиксом, если применимо. Реализация может аналогичным образом обрабатывать значения по умолчанию из других схем, однако приложениям следует использовать
Если атрибут с таким локальным именем и URI пространства имен не найден, этот метод ничего не делает.
Согласно [Пространства имен XML], приложения должны использовать значение
Document.normalizeDocument(), чтобы гарантировать актуальность этой информации. Если атрибут с таким локальным именем и URI пространства имен не найден, этот метод ничего не делает.
Согласно [Пространства имен XML], приложения должны использовать значение
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
Получает узел
Согласно [Пространства имен XML], приложения должны использовать значение
Attr по локальному имени и URI пространства имен. Согласно [Пространства имен XML], приложения должны использовать значение
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], приложения должны использовать значение
Согласно [Пространства имен XML], приложения должны использовать значение
null в качестве параметра namespaceURI методов, если им требуется отсутствие пространства имен.- Параметры:
-
newAttr— узелAttrдля добавления в список атрибутов. - Возвращает:
- Если атрибут
newAttrзаменяет существующий атрибут с теми же локальным именем и URI пространства имен, возвращается заменённый узелAttr, в противном случае возвращаетсяnull. - Выбрасывает:
-
DOMException— WRONG_DOCUMENT_ERR: возникает, еслиnewAttrбыл создан другим документом, а не тем, который создал элемент.
NO_MODIFICATION_ALLOWED_ERR: возникает, если этот узел доступен только для чтения.
INUSE_ATTRIBUTE_ERR: возникает, еслиnewAttrуже является атрибутом другого объектаElement. Для повторного использования узловAttrв других элементах пользователь DOM должен явно клонировать их.
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
Возвращает
Согласно [Пространства имен XML], приложения должны использовать значение
true, если для этого элемента задан атрибут с указанными локальным именем и URI пространства имен или для него имеется значение по умолчанию, и false в противном случае. Согласно [Пространства имен XML], приложения должны использовать значение
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
Если параметр
Чтобы указать атрибут по локальному имени и URI пространства имен, используйте метод
isId равен true, этот метод объявляет указанный атрибут идентификатором ID, определяемым пользователем. Это влияет на значение Attr.isId и поведение Document.getElementById, но не изменяет используемую схему; в частности, это не влияет на Attr.schemaTypeInfo указанного узла Attr. Чтобы отменить объявление атрибута идентификатором ID, определяемым пользователем, укажите значение false для параметра isId. Чтобы указать атрибут по локальному имени и 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. Чтобы отменить объявление атрибута идентификатором ID, определяемым пользователем, укажите значение false для параметра isId.- Параметры:
-
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. Чтобы отменить объявление атрибута идентификатором ID, определяемым пользователем, укажите значение false для параметра isId.- Параметры:
-
idAttr— узел атрибута. -
isId— является ли атрибут атрибутом типа ID. - Выбрасывает:
-
DOMException— NO_MODIFICATION_ALLOWED_ERR: возникает, если этот узел доступен только для чтения.
NOT_FOUND_ERR: возникает, если указанный узел не является атрибутом этого элемента. - Начиная с версии:
- 1.5, DOM Level 3
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.