CKTIS / JavaScript
HTMLCanvasElement : contexte de dessin et dimensions
HTMLCanvasElement fournit une surface de dessin dans le navigateur. Découvrez comment utiliser getContext(), width et height. Avec un contexte 2D, toute affectation à l’une de ces deux propriétés efface le dessin et réinitialise l’état du contexte, même si la valeur ne change pas.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
canvas.getContext(contextType, contextAttributes)
canvas.width = width;
canvas.height = height;HTMLCanvasElement représente un élément canvas dans le navigateur. L’élément lui-même contient la surface de dessin ; un contexte fournit les opérations de dessin. Il s’agit d’une API Web, et non d’une partie d’ECMAScript. La présence de Node 24 dans un dépôt ne prouve pas que cette API y est disponible.
Appelez HTMLCanvasElement.getContext sur une instance sous la forme canvas.getContext("2d") pour obtenir un CanvasRenderingContext2D. Un deuxième argument facultatif définit les paramètres du contexte. Vérifiez le résultat : la méthode renvoie null si le type n’est pas pris en charge, si l’élément possède déjà un autre mode de contexte ou si la création du contexte échoue. Par exemple, même pour un type de contexte WebGL pris en charge, un appel avec l’option failIfMajorPerformanceCaveat activée peut renvoyer null, alors qu’un nouvel appel sur le même canvas avec cette option désactivée peut réussir. Une fois le contexte créé, les appels suivants sur le même canvas avec le même type de contexte renvoient ce même objet. Après le transfert du contrôle via transferControlToOffscreen(), la méthode lève InvalidStateError.
HTMLCanvasElement.width et HTMLCanvasElement.height reflètent les attributs de dimension et déterminent la taille de la surface de dessin interne. Leurs valeurs par défaut sont respectivement 300 et 150. La taille d’affichage définie par CSS est distincte : elle met l’image à l’échelle et peut la rendre floue ou déformée.
Avec un contexte 2D, une affectation à width ou height efface la surface, supprime le tracé courant et rétablit les valeurs par défaut des paramètres du contexte, dont fillStyle, même si vous réaffectez la valeur actuelle. Définissez les dimensions avant de configurer le contexte 2D et de dessiner ; après un redimensionnement, rétablissez l’état et redessinez. Le redimensionnement du tampon de dessin WebGL ne réinitialise pas l’état du contexte WebGL. Une fois le contrôle transféré à un OffscreenCanvas par transferControlToOffscreen(), toute affectation à width ou height sur l’élément d’origine lève InvalidStateError. L’API de base est largement disponible dans les navigateurs, mais la prise en charge des types de contexte et des options varie.
Exemples
(() => {
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);
})();Résultat
300 150 true 4 2 #000000
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.