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