CKTIS / JavaScript
HTMLElement.style: transform e height
Define a transformação e a altura de um elemento através de JavaScript e distingue as declarações em linha dos valores resolvidos pela cascata CSS.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
const style = element.style;
style.transform = "translateY(12px)";
style.height = "80px";
style.removeProperty("transform");
style.height = "";HTMLElement.style devolve um objeto que reflete continuamente o atributo style do elemento. Uma referência guardada continua a refletir as alterações. A especificação atual devolve CSSStyleProperties, que herda de CSSStyleDeclaration; alguns navegadores podem ainda devolver CSSStyleDeclaration. Estas API pertencem à plataforma Web, não ao ECMAScript 2024.
Não podes substituir o objeto: atribuir diretamente a element.style define cssText e substitui o bloco de declarações. Usa element.style.transform e element.style.height para ler ou alterar declarações individuais. Atribui cadeias CSS válidas como "80px". No modo padrão, ao atribuir a height um valor diferente de zero e sem unidade, como "81", a atribuição é ignorada sem lançar uma exceção e o valor anterior mantém-se. No modo de compatibilidade (quirks mode), os navegadores podem interpretar esse valor como um comprimento em píxeis.
transform altera a forma como uma caixa transformável é desenhada: translateY(12px) desloca-a 12 píxeis CSS para baixo sem alterar o espaço que ocupa no fluxo normal. height especifica uma altura para a disposição dos elementos: por omissão, dimensiona a caixa de conteúdo; com box-sizing: border-box, dimensiona a caixa que inclui o contorno.
Ler uma declaração em linha ausente devolve "". Atribuir "" ou chamar removeProperty() remove essa declaração; isto não equivale a definir transform: none ou height: auto. Para ler os valores resolvidos após a cascata, usa o objeto só de leitura devolvido por getComputedStyle(element).
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>HTMLElement.style: transform and height</title>
</head>
<body>
<script>
(() => {
const element = document.createElement("div");
const style = element.style;
const log = () => console.log(JSON.stringify([style.transform, style.height]));
style.transform = "translateY(12px)";
style.height = "80px";
log();
style.height = "81";
log();
style.removeProperty("height");
log();
})();
</script>
</body>
</html>Resultado
["translateY(12px)","80px"] ["translateY(12px)","80px"] ["translateY(12px)",""]
Guarda o exemplo completo num ficheiro HTML e abre-o num navegador. Mantém `<!doctype html>` para que a página seja processada no modo padrão. Verifica a saída na consola do navegador. O elemento não é inserido no documento, pelo que a saída apresenta declarações em linha, não dimensões no ecrã.
Lições relacionadas
- JavaScript · Lição 11 · Avançado · Versão: 4