CKTIS / JavaScript
HTMLCanvasElement: Zeichenkontext und Abmessungen
HTMLCanvasElement stellt eine Zeichenfläche im Browser bereit. Erfahre, wie du getContext(), width und height verwendest. Bei einem 2D-Kontext löscht eine Zuweisung an eine der beiden Eigenschaften die Zeichnung und setzt den Kontextzustand zurück, auch wenn sich der Wert nicht ändert.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;HTMLCanvasElement repräsentiert ein canvas-Element im Browser. Das Element selbst enthält die Zeichenfläche; ein Kontext stellt die Zeichenoperationen bereit. Dies ist eine Web-API und kein Bestandteil von ECMAScript. Dass sich Node 24 in einem Repository befindet, belegt nicht die Verfügbarkeit dieser API.
Rufe HTMLCanvasElement.getContext für eine Instanz als canvas.getContext("2d") auf, um ein CanvasRenderingContext2D zu erhalten. Ein optionales zweites Argument legt die Kontexteinstellungen fest. Prüfe das Ergebnis: Die Methode gibt null zurück, wenn der Typ nicht unterstützt wird, das Element bereits einen anderen Kontextmodus hat oder der Kontext nicht erstellt werden kann. Selbst bei einem unterstützten WebGL-Kontexttyp kann ein Aufruf mit aktivierter Option failIfMajorPerformanceCaveat beispielsweise null zurückgeben, während ein erneuter Aufruf auf demselben Canvas mit deaktivierter Option erfolgreich sein kann. Sobald ein Kontext erfolgreich erstellt wurde, geben weitere Aufrufe auf demselben Canvas mit demselben Kontexttyp dasselbe Objekt zurück. Nachdem die Kontrolle mit transferControlToOffscreen() übertragen wurde, löst die Methode InvalidStateError aus.
HTMLCanvasElement.width und HTMLCanvasElement.height spiegeln die Abmessungsattribute wider und bestimmen die Größe der internen Zeichenfläche. Ihre Standardwerte sind 300 beziehungsweise 150. Die über CSS festgelegte Anzeigegröße ist davon getrennt: Sie skaliert das Bild und kann es unscharf oder verzerrt erscheinen lassen.
Bei einem 2D-Kontext leert eine Zuweisung an width oder height die Zeichenfläche, verwirft den aktuellen Pfad und setzt Kontexteinstellungen wie fillStyle auf ihre Standardwerte zurück. Das gilt auch, wenn du den aktuellen Wert zuweist. Lege die Abmessungen fest, bevor du den 2D-Kontext konfigurierst und zeichnest. Stelle nach einer Größenänderung den Zustand wieder her und zeichne erneut. Eine Größenänderung des WebGL-Zeichenpuffers setzt den Zustand des WebGL-Kontexts nicht zurück. Wurde die Kontrolle mit transferControlToOffscreen() an ein OffscreenCanvas übertragen, löst eine Zuweisung an width oder height des ursprünglichen Elements InvalidStateError aus. Die grundlegende API ist in Browsern weit verbreitet, die Unterstützung einzelner Kontexttypen und Optionen variiert jedoch.
Beispiele
(() => {
const canvas = document.createElement("canvas");
console.log(canvas.width, canvas.height);
canvas.width = 4;
canvas.height = 2;
const ctx = canvas.getContext("2d");
if (ctx === null) {
throw new Error("2D context unavailable");
}
console.log(canvas.getContext("2d") === ctx);
ctx.fillStyle = "#ff0000";
ctx.fillRect(0, 0, canvas.width, canvas.height);
canvas.width = canvas.width;
console.log(canvas.width, canvas.height, ctx.fillStyle);
})();Ergebnis
300 150 true 4 2 #000000
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.