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

CKTIS / HTML

Atributo height de HTML

O atributo height especifica a dimensão vertical dos elementos HTML compatíveis. Aceita um número inteiro não negativo sem unidade. Em canvas, controla a altura do mapa de píxeis, não apenas o tamanho apresentado.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

height="N"

height não é um atributo global. Aplica-se a img, iframe, embed, object, video, a input com type="image" e a source cujo elemento pai é picture. O valor é um número inteiro não negativo em píxeis CSS: escreve height="100", não height="100px" nem height="50%".

Dentro de picture, é o elemento img que apresenta a imagem; height não se aplica ao próprio picture. As dimensões num source aplicável descrevem uma variante da imagem. Os atributos de dimensão não se destinam a distorcer as proporções de um recurso.

O elemento canvas também suporta height, mas este define a altura do mapa de píxeis. Se o atributo estiver ausente ou ocorrer um erro de análise, o valor predefinido é 150; a largura predefinida é 300. O tamanho de apresentação definido através de CSS é uma questão separada.

Num contexto 2d, atribuir um valor a canvas.height limpa o mapa de píxeis e repõe o estado de desenho, mesmo que o valor não se altere. O exemplo mostra o canal alfa de um píxel desenhado a mudar de 255 para 0 após esta atribuição.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>height</title>
<canvas id="canvas" width="200" height="100"></canvas>
<pre id="output"></pre>
<script>
  const canvas = document.getElementById("canvas");
  const context = canvas.getContext("2d");
  context.fillStyle = "red";
  context.fillRect(0, 0, 20, 20);
  const before = context.getImageData(0, 0, 1, 1).data[3];
  canvas.height = 100;
  const after = context.getImageData(0, 0, 1, 1).data[3];
  document.getElementById("output").textContent =
    `${canvas.width} x ${canvas.height}\n${before} -> ${after}`;
</script>

Resultado

200 x 100
255 -> 0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes