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

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-only

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

Източници