CKTIS / JavaScript
Търсене по ID, коренов елемент и тяло на документа
Използвай `getElementById()` за търсене на елемент по ID, `documentElement` за достъп до кореновия елемент и `body` за достъп до тялото на HTML документа. И трите операции могат да върнат `null` по различни причини.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
doc.getElementById(id) // id: string; returns Element or null
doc.documentElement // read-only; returns Element or null
doc.body // returns HTMLBodyElement, HTMLFrameSetElement, or null
doc.body = newBody // assigns an HTML body or frameset elementdoc.getElementById(id) търси в дървото на документа doc. Подай точната стойност на id, без да добавяш префикс #: това не е CSS селектор и главните и малките букви се различават. Методът връща съответстващ Element или null. Идентификаторите трябва да са уникални; при дублиране се връща първото съвпадение в реда на дървото. Търсенето пропуска отделените възли и не навлиза в дърветата на Shadow DOM.
doc.documentElement е свойство само за четене: връща кореновия елемент (<html> в HTML документ; в XML може да е друг елемент) или null, ако няма такъв елемент. doc.body връща първия пряк наследник на <html>, който е <body> или остарелият <frameset>, или null, ако няма такъв наследник. Чети и двете свойства без скоби.
За разлика от documentElement, на body може да се присвои стойност, за да се замени съществуващият елемент. Неговите дъщерни възли не се преместват в новия елемент. Присвояването на null или на обект HTMLElement, който не е нито <body>, нито <frameset>, предизвиква HierarchyRequestError. Ако елементът не имплементира интерфейса HTMLElement, както е при SVG елементите, преобразуването по правилата на Web IDL предизвиква TypeError, преди да се извика сетърът. Присвояването на валиден <body> или <frameset> също предизвиква HierarchyRequestError, ако документът няма коренов елемент.
Докато HTML се анализира, тялото на документа или търсеният елемент може още да не съществува. Ако кодът зависи от HTML маркировката на страницата, изчакай DOMContentLoaded, когато document.readyState === "loading"; в противен случай го изпълни веднага. Преди употреба провери дали резултатът не е null: директното четене на свойство от null предизвиква TypeError. Тези API са дефинирани от стандартите DOM и HTML, а не от ECMAScript. Означението ECMAScript 2024 не показва дали са налични; средата за изпълнение на JavaScript не предоставя непременно document.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document lookup demo</title>
</head>
<body>
<script>
const doc = document.implementation.createHTMLDocument("Demo");
const panel = doc.createElement("section");
panel.id = "Panel";
console.log(doc.documentElement.localName);
console.log(doc.body.localName);
console.log(doc.getElementById("Panel"));
doc.body.appendChild(panel);
console.log(doc.getElementById("Panel") === panel);
console.log(doc.getElementById("panel"));
</script>
</body>
</html>Резултат
html body null true null
Запази примера като HTML файл, отвори го в браузър и провери конзолата за разработчици. Отделният HTML документ вече съдържа `html` и `body` и не променя страницата, на която се изпълнява скриптът. `Panel` се намира едва след вмъкване, а `panel` не съвпада заради разликата между главната и малката буква.
Свързани уроци
- JavaScript · Урок 37 · Напреднало · Версия: 4