Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

CSSStyleDeclaration: grubości obramowania i transform

Ustawiaj grubość każdej krawędzi obramowania i transformację CSS przez `element.style`. Odróżniaj deklaracje inline od wartości rozstrzygniętych przez przeglądarkę po uwzględnieniu kaskady.

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

Składnia

const style = element.style;
style.borderStyle = "solid";
style.borderWidth = "2px 4px 6px 8px";
style.borderTopWidth = "3px";
style.borderRightWidth = "4px";
style.borderBottomWidth = "6px";
style.borderLeftWidth = "8px";
style.transform = "translateX(12px)";
style.setProperty("border-top-width", "3px");
style.getPropertyValue("border-top-width");
getComputedStyle(element).borderTopWidth;

element.style udostępnia aktualizowany na bieżąco obiekt, którego właściwości pozwalają czytać i zmieniać deklaracje z atrybutu style elementu. W aktualnym CSSOM jest to CSSStyleProperties, które dziedziczy po CSSStyleDeclaration; starsza dokumentacja może podawać nazwę interfejsu bazowego. To API przeglądarkowe, a nie część ECMAScript 2024.

borderWidth to skrót CSS border-width. Jedna wartość dotyczy wszystkich stron; dwie oznaczają górę i dół, a następnie prawą i lewą stronę; trzy oznaczają górę, prawą i lewą stronę oraz dół; cztery podaje się w kolejności: góra, prawa, dół, lewa. Aby zmienić tylko jedną stronę, użyj borderTopWidth, borderRightWidth, borderBottomWidth lub borderLeftWidth. Podawaj ciągi znaków z wartościami CSS, np. "3px", "0" lub "thin"; liczba 3 nie oznacza trzech pikseli. Sama grubość nie wystarcza, by obramowanie było widoczne: styl none lub hidden daje grubość zero. Ustaw np. borderStyle = "solid".

style.transform = "translateX(12px)" zastępuje całą deklarację inline transform. Jeśli element można transformować i ta deklaracja wygrywa w kaskadzie, element jest wyświetlany o 12 pikseli CSS w prawo, ale jego miejsce w normalnym układzie strony się nie zmienia. Deklaracja inline może przegrać na przykład z deklaracją !important z arkusza stylów, która dotyczy tego elementu. Kilka funkcji zapisz w jednym ciągu, oddzielając je spacjami; ich kolejność ma znaczenie.

setProperty("border-top-width", "3px") i getPropertyValue("border-top-width") używają nazwy CSS z łącznikami, w przeciwieństwie do zapisu style.borderTopWidth. Odczyt style.borderTopWidth zwraca "", jeśli po tej stronie nie ma deklaracji inline. Aby odczytać wartość po uwzględnieniu kaskady dla elementu w dokumencie, użyj getComputedStyle(element); zwracany obiekt aktualizuje się na bieżąco, ale jest tylko do odczytu.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Border widths and transform</title>
</head>
<body>
  <script>
    {
      const box = document.createElement("div");
      const style = box.style;

      style.borderStyle = "solid";
      style.borderWidth = "2px 4px 6px 8px";
      style.setProperty("border-top-width", "3px");
      style.transform = "translateX(12px)";

      console.log([
        style.borderTopWidth,
        style.borderRightWidth,
        style.borderBottomWidth,
        style.borderLeftWidth,
      ].join(" "));
      console.log(style.getPropertyValue("border-top-width"));
      console.log(style.transform);
    }
  </script>
</body>
</html>

Wynik

3px 4px 6px 8px
3px
translateX(12px)

Zapisz przykład jako plik HTML, otwórz go w przeglądarce i sprawdź wynik w konsoli. Skrót ustawia cztery grubości, a `setProperty()` zmienia tylko górną. Element nie trafia do dokumentu, więc wynik pokazuje deklaracje inline, a nie wygląd elementu.

Powiązane lekcje

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

Źródła