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 eine positive integer und spiegelt das height-HTML-Attribut des <canvas>-Elements wider, interpretiert in CSS-Pixeln. Wenn das Attribut nicht angegeben ist oder auf einen ungültigen Wert wie einen negativen gesetzt wird, wird der Standardwert 150 verwendet.

Das Setzen der height-Eigenschaft setzt den gesamten Rendering-Kontext auf seinen Standardzustand zurück. Dies schließt das Löschen des Canvas (Backpuffer), das Zurücksetzen des aktuellen Pfads und das Zurücksetzen aller Eigenschaften wie fillStyle und globalCompositeOperation ein. Dieses Zurücksetzen erfolgt für alle Kontexttypen und tritt selbst dann auf, wenn height auf den aktuellen Wert gesetzt wird. Um den vorherigen Inhalt nach einer Höhenänderung 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 steuern.

Wert

Eine Zahl.

Beispiele

Gegeben ist 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