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 = valuedocument.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