CKTIS / JavaScript
HTMLCanvasElement: tekencontext en afmetingen
HTMLCanvasElement biedt een tekenoppervlak in de browser. Leer hoe je getContext(), width en height gebruikt. Bij een 2D-context wist een toewijzing aan een van beide eigenschappen de tekening en zet die de contextstatus terug, ook als de waarde niet verandert.
Versie: 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 stelt een canvas-element in de browser voor. Het element zelf bevat het tekenoppervlak; een context biedt tekenbewerkingen. Dit is een Web-API en geen onderdeel van ECMAScript. De aanwezigheid van Node 24 in een repository bewijst niet dat deze API beschikbaar is.
Roep HTMLCanvasElement.getContext op een instantie aan als canvas.getContext("2d") om een CanvasRenderingContext2D te verkrijgen. Een optioneel tweede argument bepaalt de contextinstellingen. Controleer het resultaat: de methode geeft null terug als het type niet wordt ondersteund, als het element al een andere contextmodus heeft of als het aanmaken van de context mislukt. Zelfs bij een ondersteund WebGL-contexttype kan een aanroep met failIfMajorPerformanceCaveat ingeschakeld bijvoorbeeld null teruggeven, terwijl een nieuwe poging op hetzelfde canvas met die optie uitgeschakeld kan slagen. Zodra de context is aangemaakt, geven volgende aanroepen op hetzelfde canvas met hetzelfde contexttype datzelfde object terug. Nadat de besturing is overgedragen via transferControlToOffscreen(), veroorzaakt de methode InvalidStateError.
HTMLCanvasElement.width en HTMLCanvasElement.height weerspiegelen de dimensieattributen en bepalen de grootte van het interne tekenoppervlak. De standaardwaarden zijn respectievelijk 300 en 150. De weergavegrootte die via CSS is ingesteld, staat hier los van: die schaalt de afbeelding en kan deze wazig of vervormd maken.
Als je bij een 2D-context een waarde toewijst aan width of height, wordt het tekenoppervlak gewist, verdwijnt het huidige pad en krijgen contextinstellingen zoals fillStyle weer hun standaardwaarde. Dat gebeurt ook als je de huidige waarde toewijst. Stel de afmetingen in voordat je de 2D-context configureert en tekent; herstel na het wijzigen van de grootte de contextstatus en teken opnieuw. Als je de grootte van de WebGL-tekenbuffer wijzigt, blijft de status van de WebGL-context behouden. Nadat de besturing via transferControlToOffscreen() is overgedragen aan een OffscreenCanvas, leidt een toewijzing aan width of height op het oorspronkelijke element tot InvalidStateError. De basis-API is breed beschikbaar in browsers, maar de ondersteuning voor afzonderlijke contexttypen en opties verschilt.
Voorbeelden
(() => {
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);
})();Resultaat
300 150 true 4 2 #000000
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.