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