CKTIS / HTML
Attribut height en HTML
L’attribut height définit la dimension verticale des éléments HTML compatibles. Il prend un entier non négatif sans unité. Sur canvas, il détermine la hauteur du bitmap, et pas seulement la taille affichée.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
height="N"height n’est pas un attribut global. Il s’applique à img, iframe, embed, object, video, à input avec type="image", ainsi qu’à source dont le parent est picture. Sa valeur est un entier non négatif en pixels CSS : écrivez height="100", et non height="100px" ou height="50%".
Dans picture, c’est l’élément img qui affiche l’image ; height ne s’applique pas à picture lui-même. Les dimensions indiquées sur un élément source compatible décrivent une variante de l’image. Les attributs de dimension ne servent pas à déformer les proportions d’une ressource.
L’élément canvas prend également en charge height, mais cet attribut définit la hauteur du bitmap. Si l’attribut est absent ou si son analyse échoue, la valeur par défaut est 150 ; la largeur par défaut est 300. La taille d’affichage définie par CSS est une question distincte.
Avec un contexte 2d, affecter une valeur à canvas.height efface le bitmap et réinitialise l’état de dessin, même si la valeur ne change pas. L’exemple montre que le canal alpha d’un pixel dessiné passe de 255 à 0 après cette affectation.
Exemples
<!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>Résultat
200 x 100 255 -> 0
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.