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

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 element

doc.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

Източници