CKTIS / JavaScript
Document.getElementById() и documentElement: търсене по ID и коренов елемент
`getElementById()` търси елемент по точната стойност на неговия ID, а `documentElement` дава кореновия елемент на документа. И в двата случая резултатът може да е `null`, но по различни причини.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
doc.getElementById(id) // Element or null
doc.documentElement // Element or null; read-onlydoc.getElementById(id) претърсва текущото дърво на документа doc. Подай самия ID, например 'Panel', без да добавяш префикса # от CSS селектор. Методът различава главни и малки букви и връща Element или null, ако няма съвпадение. В HTML идентификаторите трябва да са уникални в рамките на своето дърво. При дублиране методът връща първото съвпадение според реда в дървото.
Търсенето не обхваща елементи, които не са вмъкнати в това дърво, нито елементи в дървета на shadow DOM. Ако скриптът се изпълни преди вмъкването, резултатът може да е null. Провери го, преди да достъпиш негово свойство. Следващо извикване търси отново, но запазена референция към елемента не се променя при премахването му.
doc.documentElement е свойство само за четене, а не метод. То връща кореновия елемент независимо от неговия ID: html в типичен HTML документ или елемента, който е корен в XML. Това не е нито самият възел Document, нито body. Ако няма коренов елемент, стойността е null.
И двата члена са част от уеб API на DOM, а не от ECMAScript 2024. Самата поддръжка на JavaScript не гарантира, че document е наличен.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document ID lookup and root element</title>
</head>
<body>
<script>
(() => {
const doc = document.implementation.createHTMLDocument('Demo');
const panel = doc.createElement('div');
panel.id = 'Panel';
console.log(doc.documentElement.localName);
console.log(doc.getElementById('Panel'));
doc.body.appendChild(panel);
console.log(doc.getElementById('Panel') === panel);
console.log(doc.getElementById('panel'));
console.log(new Document().documentElement);
})();
</script>
</body>
</html>Резултат
html null true null null
Запази примера като файл с разширение `.html`, отвори го в браузър и провери резултатите в конзолата за разработчици. Примерът създава отделен HTML документ, без да променя текущата страница. `'Panel'` се намира едва след вмъкването, `'panel'` не съвпада, а нов празен `Document` няма коренов елемент.
Свързани уроци
- JavaScript · Урок 19 · Напреднало · Версия: 4
- JavaScript · Урок 33 · Напреднало · Версия: 4