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

CKTIS / JavaScript

HTMLCanvasElement : largeur et hauteur du bitmap

`canvas.width` et `canvas.height` fixent les dimensions du bitmap, pas celles de l’affichage CSS. En 2D, même réaffecter la valeur actuelle efface le dessin et réinitialise l’état de rendu.

Version : Current web platform; runtime support varies

Syntaxe

canvas.width
canvas.height
canvas.width = widthInPixels;
canvas.height = heightInPixels;

canvas.width et canvas.height sont deux propriétés accessibles en lecture et en écriture sur un élément canvas. Elles reflètent les attributs HTML du même nom et fixent la largeur et la hauteur du bitmap en pixels. Indiquez des entiers positifs ou nuls dans les attributs HTML. Si un attribut est absent ou ne peut pas être interprété comme un tel entier, sa valeur par défaut est 300 pour la largeur ou 150 pour la hauteur. Ces propriétés relèvent de la plateforme web, pas d’ECMAScript.

canvas.style.width et canvas.style.height déterminent la taille de l’élément dans la mise en page, pas celle du bitmap. Une modification du CSS seul laisse les pixels et le dessin intacts. L’image affichée peut devenir floue si elle est agrandie ou se déformer si ses proportions changent.

Avec un contexte 2d, affecter l’une ou l’autre dimension du bitmap efface le dessin et réinitialise le même contexte, même si la valeur ne change pas. Le tracé courant, la transformation et les styles font partie de l’état réinitialisé. Fixez les dimensions avant de dessiner. Si vous les modifiez ensuite, rétablissez l’état nécessaire et redessinez.

Ne supposez pas que WebGL ou WebGPU se réinitialise comme 2d. Après transferControlToOffscreen(), l’élément sert d’emplacement d’affichage : écrire dans son width ou son height lève InvalidStateError. Réglez plutôt les dimensions sur l’objet OffscreenCanvas.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Canvas bitmap dimensions</title>
</head>
<body>
<script>
(() => {
  const canvas = document.createElement('canvas');
  console.log(`Default: ${canvas.width} × ${canvas.height}`);

  canvas.width = 4;
  canvas.height = 2;
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D is unavailable.');

  ctx.fillRect(0, 0, 1, 1);
  ctx.globalAlpha = 0.5;
  const pixelAlpha = () => ctx.getImageData(0, 0, 1, 1).data[3];

  canvas.style.width = '40px';
  canvas.style.height = '20px';
  console.log(`After CSS: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);

  canvas.width = canvas.width;
  console.log(`After assignment: ${canvas.width} × ${canvas.height}; pixel alpha ${pixelAlpha()}; globalAlpha ${ctx.globalAlpha}`);
})();
</script>
</body>
</html>

Résultat

Default: 300 × 150
After CSS: 4 × 2; pixel alpha 255; globalAlpha 0.5
After assignment: 4 × 2; pixel alpha 0; globalAlpha 1

Ouvrez le fichier HTML dans un navigateur et consultez la sortie dans sa console. Le canvas n’est pas ajouté à la page. La modification du CSS laisse le pixel opaque (`255`) ; réaffecter la même largeur l’efface (`0`) et ramène `globalAlpha` à `1`.

Leçons associées

  • JavaScript · Leçon 26 · Intermédiaire · Version : 3
  • JavaScript · Leçon 27 · Intermédiaire · Version : 3

Sources