CKTIS / HTML
HTML-Attribut height
Das Attribut height legt die vertikale Abmessung unterstützter HTML-Elemente fest. Es nimmt eine nichtnegative Ganzzahl ohne Einheit an. Bei canvas bestimmt es die Höhe der Bitmap, nicht nur die angezeigte Größe.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
height="N"height ist kein globales Attribut. Es gilt für img, iframe, embed, object, video, input mit type="image" sowie für source, dessen übergeordnetes Element picture ist. Der Wert ist eine nichtnegative Ganzzahl in CSS-Pixeln: Schreibe height="100", nicht height="100px" oder height="50%".
Innerhalb von picture zeigt das Element img das Bild an; height gehört nicht auf picture selbst. Abmessungen auf einem passenden source beschreiben eine Bildvariante. Dimensionsattribute sind nicht dazu gedacht, das Seitenverhältnis einer Ressource zu verzerren.
Auch das Element canvas unterstützt height, legt damit aber die Höhe der Bitmap fest. Fehlt das Attribut oder tritt ein Parsing-Fehler auf, gilt standardmäßig 150; die Standardbreite beträgt 300. Die über CSS festgelegte Anzeigegröße ist davon unabhängig.
Bei einem 2d-Kontext löscht die Zuweisung von canvas.height die Bitmap und setzt den Zeichenstatus zurück, selbst wenn sich der Wert nicht ändert. Das Beispiel zeigt, wie sich der Alphakanal eines gezeichneten Pixels nach dieser Zuweisung von 255 auf 0 ändert.
Beispiele
<!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>Ergebnis
200 x 100 255 -> 0
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.