Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Dokument DOM: wyszukiwanie po ID, element główny i tytuł

Wyszukaj element po dokładnym ID, pobierz element główny dokumentu oraz odczytaj lub zmień jego tytuł. Rozróżnij brak węzła od pustego tekstu.

Wersja: Current web platform; runtime support varies

Składnia

document.getElementById(id)
document.documentElement
document.title
document.title = value

document.getElementById(id) wyszukuje w drzewie danego dokumentu element o dokładnie takim id. Wielkość liter ma znaczenie. Podaj samo ID, bez dodawania #, ponieważ argument nie jest selektorem CSS. Metoda zwraca Element albo null; sprawdź wynik przed dostępem do właściwości elementu. Identyfikatory powinny być unikatowe w obrębie drzewa. Przy duplikatach metoda zwraca pierwszy pasujący element w kolejności drzewa.

Wyszukiwanie uwzględnia aktualny stan drzewa. Nie znajdzie elementu, którego jeszcze nie wstawiono do dokumentu, ani elementu w osobnym drzewie shadow DOM. document.documentElement to właściwość tylko do odczytu: zwraca element główny, zwykle html w dokumencie HTML, albo null, jeśli dokument nie ma elementu głównego. Nie jest to document.body.

document.title to właściwość tekstowa do odczytu i zapisu, a nie węzeł title, atrybut title elementu ani widoczny nagłówek. W typowym dokumencie HTML odczyt usuwa skrajne białe znaki ASCII i zastępuje ich wewnętrzne ciągi pojedynczą spacją. Gdy nie ma elementu title, zwraca "". Przypisanie zastępuje zawartość tytułu tekstem, nie kodem HTML. Jeśli brakuje elementu title, przypisanie tworzy go w head, o ile head istnieje; w przeciwnym razie nic nie zmienia. Gdy korzeniem jest svg z przestrzeni nazw SVG, zapis aktualizuje lub tworzy jego bezpośredni element potomny title w przestrzeni nazw SVG, z którego odczytywany jest tytuł.

Te interfejsy API platformy WWW definiują standardy DOM i HTML. Korzystanie z nich nie wymaga ECMAScript 2024. W dokumencie wyświetlanym w karcie tytuł zwykle pojawia się na jej etykiecie. Środowisko bez DOM nie musi udostępniać obiektu document.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOM document example</title>
</head>
<body>
  <script>
    {
      const doc = document.implementation.createHTMLDocument("Draft");
      const item = doc.createElement("p");
      item.id = "status";

      console.log(doc.title);
      console.log(doc.getElementById("status") === null);
      doc.body.append(item);
      console.log(doc.getElementById("status") === item);
      console.log(doc.getElementById("Status") === null);
      console.log(doc.documentElement.localName);

      doc.title = "  Ready   to publish  ";
      console.log(doc.title);
    }
  </script>
</body>
</html>

Wynik

Draft
true
true
true
html
Ready to publish

Zapisz cały przykład jako plik HTML, otwórz go w przeglądarce i sprawdź komunikaty w konsoli narzędzi deweloperskich. Przykład tworzy osobny dokument HTML, więc nie zmienia bieżącej strony ani tytułu karty. Trzy wartości `true` potwierdzają kolejno brak wyniku przed wstawieniem, zgodność obiektu po wstawieniu i rozróżnianie wielkości liter.

Powiązane lekcje

  • JavaScript · Lekcja 38 · Zaawansowany · Wersja: 4

Źródła