Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLCanvasElement : contexte de rendu et dimensions du bitmap

Choisissez le contexte avec `getContext()` et dimensionnez le bitmap avec `width` et `height`. Contrairement au dimensionnement CSS, une affectation efface le bitmap et réinitialise l’état de dessin en mode 2D.

Version : Current web platform; runtime support varies

Syntaxe

canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeight

HTMLCanvasElement est une interface de navigateur définie par HTML, et non par ECMAScript 2024. canvas.getContext(contextId, options) prend un identifiant sous forme de chaîne et des options facultatives propres au mode. "2d" sélectionne CanvasRenderingContext2D, "bitmaprenderer" sélectionne ImageBitmapRenderingContext, "webgl" sélectionne WebGLRenderingContext, "webgl2" sélectionne WebGL2RenderingContext et "webgpu" sélectionne GPUCanvasContext. La disponibilité des modes et des options dépend de l’environnement d’exécution.

Le premier appel réussi fixe le mode de l’élément. Un nouvel appel avec le même identifiant renvoie le même objet sans appliquer de nouveaux réglages. Un mode non pris en charge ou indisponible, ou une demande de changement de mode, donne null. Après un appel réussi à transferControlToOffscreen(), l’élément sert d’emplacement réservé : appeler getContext() ou affecter width ou height déclenche InvalidStateError.

canvas.width et canvas.height reflètent les attributs HTML du même nom. Ces propriétés donnent la largeur et la hauteur du bitmap en nombres entiers non négatifs. Si un attribut manque ou si son analyse échoue, sa valeur par défaut est respectivement 300 ou 150. Ne modifier que canvas.style.width ou canvas.style.height change la taille d’affichage, pas la résolution du bitmap ; la mise à l’échelle peut rendre l’image floue.

En mode 2D, affecter l’une des dimensions, même avec sa valeur actuelle, efface le bitmap et réinitialise l’état de dessin, notamment le tracé en cours, la transformation et les styles, sans remplacer le contexte. Fixez les dimensions avant de dessiner. Après un redimensionnement, rétablissez l’état nécessaire et redessinez. Ne supposez pas que les autres modes se réinitialisent de la même façon.

Dessiner une image d’une autre origine sans autorisation CORS appropriée peut faire perdre au bitmap son état origin-clean. getImageData() déclenche alors SecurityError ; redimensionner un bitmap 2D supprime son contenu au lieu de rendre lisibles les pixels bloqués.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
  const canvas = document.createElement("canvas");
  console.log(`${canvas.width}x${canvas.height}`);
  canvas.width = 4;
  canvas.height = 3;
  console.log(`${canvas.width}x${canvas.height}`);

  const ctx = canvas.getContext("2d");
  if (ctx === null) throw new Error("2D canvas context unavailable");

  ctx.fillRect(0, 0, 1, 1);
  ctx.globalAlpha = 0.5;
  const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
  console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);

  canvas.width = canvas.width;
  console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
  console.log(canvas.getContext("2d") === ctx);
  console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>

Résultat

300x150
4x3
255 0.5
0 1
true
true

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez les résultats dans la console de développement. Les deux premières lignes affichent les dimensions. Réaffecter la même largeur fait passer l’alpha du pixel de `255` à `0` et ramène `globalAlpha` de `0.5` à `1`. Les deux valeurs `true` montrent que le contexte est conservé et qu’un autre mode est refusé.

Leçons associées

  • JavaScript · Leçon 12 · Avancé · Version : 4
  • JavaScript · Leçon 33 · Avancé · Version : 4
  • JavaScript · Leçon 34 · Avancé · Version : 4

Sources