Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

CSSStyleDeclaration: espessuras do contorno e transform

Define a espessura de cada lado do contorno e uma transformação CSS através de `element.style`. Distingue as declarações em linha dos valores que o navegador resolve após aplicar a cascata.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

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 dá acesso a um objeto que se atualiza automaticamente e cujas propriedades permitem ler e alterar as declarações no atributo style de um elemento. No CSSOM atual, é um objeto CSSStyleProperties, que herda de CSSStyleDeclaration; a documentação mais antiga pode indicar a interface base. Esta API do navegador não faz parte do ECMAScript 2024.

borderWidth corresponde à propriedade abreviada border-width. Um valor aplica-se a todos os lados; com dois valores, o primeiro aplica-se aos lados superior e inferior e o segundo aos lados direito e esquerdo; três aplicam-se a cima, direita/esquerda e baixo; quatro seguem a ordem cima, direita, baixo e esquerda. Para alterar só um lado, usa borderTopWidth, borderRightWidth, borderBottomWidth ou borderLeftWidth. Usa cadeias de caracteres com valores CSS, como "3px", "0" ou "thin"; o número 3 não significa três píxeis. A espessura por si só não torna o contorno visível: com um estilo none ou hidden, a espessura resolve-se para zero. Define, por exemplo, borderStyle = "solid".

style.transform = "translateX(12px)" substitui toda a declaração em linha transform. Se o elemento admitir transformações e esta declaração prevalecer na cascata, a sua representação desloca-se 12 píxeis CSS para a direita, sem mudar o lugar que ocupa no fluxo normal. Uma declaração !important numa folha de estilos do autor que se aplique ao elemento pode prevalecer sobre a declaração em linha. Para combinar várias funções, escreve-as numa única cadeia separadas por espaços; a ordem é importante.

setProperty("border-top-width", "3px") e getPropertyValue("border-top-width") usam o nome CSS com hífenes, ao contrário de style.borderTopWidth. Se não houver uma declaração em linha para esse lado, style.borderTopWidth devolve "". Para ler o valor resolvido após a cascata para um elemento no documento, usa getComputedStyle(element); o resultado atualiza-se automaticamente, mas é só de leitura.

Exemplos

<!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>

Resultado

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

Guarda o exemplo como ficheiro HTML, abre-o num navegador e consulta a consola de programação. A propriedade abreviada define as quatro espessuras e `setProperty()` altera apenas a do lado superior. Como o elemento não é inserido no documento, a saída mostra declarações em linha, não o resultado visual.

Lições relacionadas

  • JavaScript · Lição 35 · Intermédio · Versão: 3

Fontes