База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Document.documentElement — кореновият елемент на документа

Document.documentElement връща кореновия елемент на документа или null. Свойството е само за четене, но самият елемент може да се променя.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

document.documentElement

Четете Document.documentElement от екземпляр на Document, например чрез document.documentElement. То връща Element, чийто родител е документът, или null, ако такъв елемент няма. Един документ може да има най-много един такъв елемент.

HTML анализаторът обикновено създава елемент html като коренов елемент на документа, но DOM не изисква това име на тага. Ако замените кореновия елемент с друг елемент, например body, свойството връща новия елемент. В XML името му зависи от документа. Не бъркайте това свойство с firstChild, което може вместо това да препраща например към декларация за типа на документа.

Това, че свойството е само за четене, не означава, че върнатият елемент е неизменяем. Примерът премахва корена на отделен XML документ; при следващото прочитане се връща null. Това е DOM API, а не функция на езика ECMAScript.

Примери

const doc = document.implementation.createDocument(null, "root");
console.log(doc.documentElement.localName);
doc.documentElement.remove();
console.log(doc.documentElement);

Резултат

root
null

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници