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

Wenn die height-Eigenschaft gesetzt wird, wird der Zeichenpuffer immer auf leer zurückgesetzt - dies gilt für alle Kontexttypen, sogar wenn die Höhe auf denselben Wert gesetzt wird. Falls Sie den vorherigen Inhalt wiederherstellen müssen, können Sie ihn mittels CanvasRenderingContext2D.getImageData() speichern und mittels CanvasRenderingContext2D.putImageData() wiederherstellen.

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

Wert

Eine Zahl.

Beispiele

Angenommen, dieses <canvas> Element:

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

Sie können die Höhe des Canvas mit dem folgenden Code ermitteln:

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

Spezifikationen

Specification
HTML Standard
# dom-canvas-height

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch