Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje