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.