CKTIS / JavaScript
CSSStyleDeclaration: tloušťky ohraničení a transform
Nastavte tloušťku ohraničení na jednotlivých stranách a transformaci CSS přes `element.style`. Rozlišujte deklarace v atributu `style` od hodnot, které prohlížeč určí po uplatnění kaskády.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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 poskytuje objekt, který průběžně odráží změny a jehož vlastnosti umožňují číst a měnit deklarace v atributu style prvku. V současném CSSOM je to objekt CSSStyleProperties, který dědí z CSSStyleDeclaration; starší dokumentace může uvádět základní rozhraní. Toto rozhraní prohlížeče není součástí ECMAScriptu 2024.
borderWidth odpovídá zkrácené vlastnosti border-width. Jedna hodnota platí pro všechny strany; dvě pro horní/dolní a pravou/levou; tři pro horní, pravou/levou a dolní; čtyři pro horní, pravou, dolní a levou. Pro změnu jediné strany použijte borderTopWidth, borderRightWidth, borderBottomWidth nebo borderLeftWidth. Hodnoty CSS zadávejte jako řetězce, například "3px", "0" nebo "thin"; číslo 3 neznamená tři pixely. Samotná tloušťka ohraničení nezviditelní: u stylu none nebo hidden je výsledná tloušťka nulová. Nastavte například borderStyle = "solid".
style.transform = "translateX(12px)" nahradí celou deklaraci transform v atributu style. Pokud lze prvek transformovat a tato deklarace v kaskádě zvítězí, posune se jeho vykreslení o 12 CSS pixelů doprava, aniž se přesune jeho místo v běžném toku dokumentu. Deklarace s !important v autorově stylopisu, která se na prvek vztahuje, může mít před deklarací v atributu style přednost. Více funkcí zapište do jednoho řetězce oddělených mezerami; záleží na pořadí.
setProperty("border-top-width", "3px") a getPropertyValue("border-top-width") používají název CSS se spojovníky, na rozdíl od style.borderTopWidth. Pokud v atributu style není deklarace pro danou stranu, style.borderTopWidth vrátí "". Pro hodnotu určenou po uplatnění kaskády u prvku v dokumentu použijte getComputedStyle(element); výsledek se průběžně aktualizuje, ale je jen pro čtení.
Příklady
<!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>Výsledek
3px 4px 6px 8px 3px translateX(12px)
Uložte příklad jako soubor HTML, otevřete ho v prohlížeči a zkontrolujte výstup v konzoli. Zkrácená vlastnost nastaví čtyři tloušťky a `setProperty()` změní jen horní. Prvek se nevkládá do dokumentu, takže výstup ukazuje deklarace v atributu `style`, nikoli vykreslený výsledek.
Související lekce
- JavaScript · Lekce 35 · Středně pokročilá · Verze: 3