HTMLCanvasElement: height-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die HTMLCanvasElement.height-Eigenschaft ist ein positiver integer, der das height HTML-Attribut des <canvas>-Elements widerspiegelt und in CSS-Pixeln interpretiert wird. Wenn das Attribut nicht angegeben ist oder auf einen ungültigen Wert, wie z. B. ein negativer, gesetzt ist, wird der Standardwert 150 verwendet.

Das Setzen der height-Eigenschaft setzt den gesamten Rendering-Kontext in seinen Standardzustand zurück. Dies beinhaltet das Löschen des Canvas (Backpuffer), das Zurücksetzen des aktuellen Pfades und das Zurücksetzen aller Eigenschaften wie fillStyle und globalCompositeOperation. Dieser Reset erfolgt für alle Kontexttypen und tritt sogar auf, wenn die height auf ihren aktuellen Wert gesetzt wird. Um den vorherigen Inhalt nach dem Ändern der Höhe wiederherzustellen, verwenden Sie CanvasRenderingContext2D.getImageData() und CanvasRenderingContext2D.putImageData(). Kontexteigenschaften müssen separat verfolgt und wiederhergestellt werden.

Dies ist eine von zwei Eigenschaften, die andere ist HTMLCanvasElement.width, die die Größe des Canvas steuert.

Wert

Eine Zahl.

Beispiele

Gegeben dieses <canvas>-Element:

html
<canvas id="canvas" width="300" height="300"></canvas>

Sie können die Höhe des Canvas mit folgendem Code abrufen:

js
const canvas = document.getElementById("canvas");
console.log(canvas.height); // 300

Spezifikationen

Specification
HTML
# dom-canvas-height

Browser-Kompatibilität

Siehe auch