Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Odczytywanie `visibility` za pomocą `window.getComputedStyle()`

Odczytaj rozstrzygniętą przez przeglądarkę wartość CSS `visibility` i odróżnij ją od deklaracji zapisanej bezpośrednio w stylu elementu.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

window.getComputedStyle(element).visibility
window.getComputedStyle(element, "::before").visibility
window.getComputedStyle(element).getPropertyValue("visibility")
element.style.visibility = "hidden"

window.getComputedStyle(element) zwraca obiekt stylów tylko do odczytu, który na bieżąco odzwierciedla zmiany. Jego właściwość .visibility zwraca ciąg znaków z wartością CSS po uwzględnieniu kaskady i dziedziczenia. Tę samą wartość zwraca getPropertyValue("visibility"). W aktualnym interfejsie wynik ma typ CSSStyleProperties, który dziedziczy po CSSStyleDeclaration; starsze wersje specyfikacji podawały CSSStyleDeclaration bezpośrednio. To API platformy webowej, a nie część ECMAScript 2024.

Pomiń drugi argument lub podaj null, aby odczytać styl samego elementu. Podaj np. "::before", aby odczytać styl pseudoelementu. Pierwszy argument musi być obiektem typu Element; przekazanie wartości innego typu powoduje TypeError. Jeśli parsowanie selektora pseudoelementu się nie powiedzie lub wynikiem parsowania jest ::part() albo ::slotted(), zgodnie z algorytmem CSSOM metoda zwraca obiekt stylów bez deklaracji, zamiast zgłaszać TypeError. Przeglądarki mogą maskować wartości stylów związanych z :visited, aby chronić historię przeglądania.

element.style.visibility odczytuje tylko deklarację w stylu bezpośrednim: zwraca "", jeśli takiej deklaracji nie ma. Ustawiaj tę właściwość na element.style, nie na wyniku getComputedStyle(). Ponowny odczyt .visibility z tego samego obiektu wyniku uwzględnia zmianę, ale wcześniej zapisany ciąg znaków się nie zmienia.

hidden ukrywa pole elementu, lecz zachowuje jego miejsce w układzie; potomek może ustawić visible, aby nadpisać dziedziczoną wartość. display: none usuwa pole z układu. collapse może również zwolnić miejsce, np. w przypadku wierszy lub kolumn tabeli; efekt zależy od rodzaju elementu i obsługi w przeglądarce. Sama wartość visible nie dowodzi, że element jest widoczny na ekranie: jego przodek może mieć display: none.

Przykłady

<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <title>Computed and inline visibility</title>
</head>
<body>
  <script>
    const parentElement = document.createElement("div");
    const child = document.createElement("span");
    parentElement.style.visibility = "hidden";
    child.textContent = "Example";
    parentElement.append(child);
    document.body.append(parentElement);

    try {
      const styles = window.getComputedStyle(child);
      console.log(JSON.stringify([child.style.visibility, styles.visibility]));

      child.style.visibility = "visible";
      console.log(JSON.stringify([child.style.visibility, styles.visibility]));
    } finally {
      parentElement.remove();
    }
  </script>
</body>
</html>

Wynik

["","hidden"]
["visible","visible"]

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i odczytaj wynik w konsoli deweloperskiej. Pierwszy wiersz zestawia brak deklaracji bezpośredniej z odziedziczonym `hidden`. Drugi pokazuje, że ten sam obiekt stylów zgłasza teraz `visible`.

Powiązane lekcje

  • JavaScript · Lekcja 40 · Średniozaawansowany · Wersja: 3

Źródła