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

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

Fontes