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:
<canvas id="canvas" width="300" height="300"></canvas>
Sie können die Höhe des Canvas mit folgendem Code abrufen:
const canvas = document.getElementById("canvas");
console.log(canvas.height); // 300
Spezifikationen
Specification |
---|
HTML # dom-canvas-height |
Browser-Kompatibilität
Siehe auch
HTMLCanvasElement
: Schnittstelle zur Definition derHTMLCanvasElement.height
-EigenschaftHTMLCanvasElement.width
: Andere Eigenschaft zur Steuerung der Größe des CanvasHTMLEmbedElement.height
HTMLIFrameElement.height
HTMLImageElement.height
HTMLObjectElement.height
HTMLSourceElement.height
HTMLVideoElement.height