Интерфейс HTMLDocument

Все суперинтерфейсы:: Document, Node

public interface HTMLDocument extends Document

Объект HTMLDocument является корнем иерархии HTML и содержит всё содержимое. Помимо доступа к иерархии, он также предоставляет несколько удобных методов для получения определённых наборов сведений из документа.

Следующие свойства устарели; вместо них следует использовать соответствующие свойства элемента BODY: alinkColor background bgColor fgColor linkColor vlinkColor В DOM Level 2 метод getElementById наследуется от интерфейса Document, куда он был перенесён.

См. также спецификацию объектной модели документа (DOM) Level 2.

Начиная с:: 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

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`close()`	Закрывает поток документа, открытый методом `open()`, и принудительно выполняет отрисовку.
`HTMLCollection`	`getAnchors()`	Коллекция всех элементов-якорей (`A`) документа, имеющих значение атрибута `name`.
`HTMLCollection`	`getApplets()`	Коллекция всех элементов `OBJECT` документа, включая апплеты и элементы `APPLET` ( устаревшие ).
`HTMLElement`	`getBody()`	Элемент, содержащий содержимое документа.
`String`	`getCookie()`	Файлы cookie, связанные с этим документом.
`String`	`getDomain()`	Доменное имя сервера, предоставившего документ, или `null`, если сервер невозможно определить по доменному имени.
`NodeList`	`getElementsByName(String elementName)`	Возвращает коллекцию элементов, возможно пустую, значение `name` которых задаётся параметром `elementName`.
`HTMLCollection`	`getForms()`	Коллекция всех форм документа.
`HTMLCollection`	`getImages()`	Коллекция всех элементов `IMG` документа.
`HTMLCollection`	`getLinks()`	Коллекция всех элементов `AREA` и элементов-якорей ( `A` ) документа, имеющих значение атрибута `href`.
`String`	`getReferrer()`	Возвращает URI страницы, содержащей ссылку на эту страницу.
`String`	`getTitle()`	Заголовок документа, заданный элементом `TITLE` в его разделе head.
`String`	`getURL()`	Полный URI документа.
`void`	`open()`	Примечание.
`void`	`setBody(HTMLElement body)`
`void`	`setCookie(String cookie)`
`void`	`setTitle(String title)`
`void`	`write(String text)`	Записывает строку текста в поток документа, открытый методом `open()`.
`void`	`writeln(String text)`	Записывает строку текста с последующим символом новой строки в поток документа, открытый методом `open()`.

Методы, объявленные в интерфейсе Document

adoptNode, createAttribute, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createElement, createElementNS, createEntityReference, createProcessingInstruction, createTextNode, getDoctype, getDocumentElement, getDocumentURI, getDomConfig, getElementById, getElementsByTagName, getElementsByTagNameNS, getImplementation, getInputEncoding, getStrictErrorChecking, getXmlEncoding, getXmlStandalone, getXmlVersion, importNode, normalizeDocument, renameNode, setDocumentURI, setStrictErrorChecking, setXmlStandalone, setXmlVersion

Методы, объявленные в интерфейсе 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

Подробное описание методов

getTitle

String getTitle()

Заголовок документа, заданный элементом TITLE в его разделе head.

setTitle

void setTitle(String title)

getReferrer

String getReferrer()

Возвращает URI страницы, содержащей ссылку на эту страницу. Значение представляет собой пустую строку, если пользователь перешёл на страницу напрямую (не по ссылке, а, например, из закладки).

getDomain

String getDomain()

Доменное имя сервера, предоставившего документ, или null, если сервер невозможно определить по доменному имени.

getURL

String getURL()

Полный URI документа.

getBody

HTMLElement getBody()

Элемент, содержащий содержимое документа. В документах с содержимым BODY возвращает элемент BODY. В документах с наборами фреймов возвращает внешний элемент FRAMESET.

setBody

void setBody(HTMLElement body)

getImages

HTMLCollection getImages()

Коллекция всех элементов IMG документа. Для обеспечения обратной совместимости учитываются только элементы IMG.

getApplets

HTMLCollection getApplets()

Коллекция всех элементов OBJECT документа, включая апплеты и элементы APPLET ( устаревшие ).

getLinks

HTMLCollection getLinks()

Коллекция всех элементов AREA и элементов-якорей ( A ) документа, имеющих значение атрибута href.

getForms

HTMLCollection getForms()

Коллекция всех форм документа.

getAnchors

HTMLCollection getAnchors()

Коллекция всех элементов-якорей (A), имеющих значение атрибута name. Примечание. Для обеспечения обратной совместимости возвращаемый набор якорей содержит только якоря, созданные с помощью атрибута name, но не якоря, созданные с помощью атрибута id.

getCookie

String getCookie()

Файлы cookie, связанные с этим документом. Если таких файлов нет, возвращается пустая строка. В противном случае возвращается строка — список пар «имя, значение» всех файлов cookie, связанных со страницей, разделённых точкой с запятой. Например, name=value;expires=date.

setCookie

void setCookie(String cookie)

open

void open()

Примечание. Этот метод и следующие за ним методы позволяют пользователю добавлять строки необработанного HTML или заменять ими структурную модель документа. На момент написания документа рассматривались альтернативные методы предоставления аналогичной функциональности для HTML- и XML-документов. В будущем следующие методы могут быть объявлены устаревшими в пользу более универсального механизма.
Открывает поток документа для записи. Если целевой документ существует, этот метод очищает его.

close

void close()

Закрывает поток документа, открытый методом open(), и принудительно выполняет отрисовку.

write

void write(String text)

Записывает строку текста в поток документа, открытый методом open(). Текст разбирается и добавляется в структурную модель документа.

Параметры:: text — строка, которую необходимо разобрать и добавить в структуру документа.

writeln

void writeln(String text)

Записывает строку текста с последующим символом новой строки в поток документа, открытый методом open(). Текст разбирается и добавляется в структурную модель документа.

Параметры:: text — строка, которую необходимо разобрать и добавить в структуру документа.

getElementsByName

NodeList getElementsByName(String elementName)

Возвращает коллекцию элементов, возможно пустую, значение name которых задаётся параметром elementName.

Параметры:: elementName — значение атрибута name элемента.
Возвращает:: Соответствующие элементы.

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.xml.dom/org/w3c/dom/html/HTMLDocument.html