<canvas>

Une toile pour dessiner des graphiques bitmap avec JavaScript.

Affichage
inline (élément remplacé)
Balise fermante
Obligatoire
Contenu autorisé
Un contenu de remplacement, visible quand la toile ne fonctionne pas, par exemple avec JavaScript désactivé
Sur cette page

Exemple

#
HTML
<canvas id="scene" width="320" height="150">
  Un carré violet, un cercle orange et une ligne bleue.
</canvas>
<script>
  const ctx = document.getElementById('scene').getContext('2d')

  ctx.fillStyle = '#8b5cf6'
  ctx.fillRect(20, 20, 80, 80)

  ctx.beginPath()
  ctx.arc(165, 60, 40, 0, Math.PI * 2)
  ctx.fillStyle = '#f97316'
  ctx.fill()

  ctx.beginPath()
  ctx.moveTo(230, 100)
  ctx.lineTo(300, 20)
  ctx.strokeStyle = '#38bdf8'
  ctx.lineWidth = 6
  ctx.stroke()

  ctx.fillStyle = '#e5e7eb'
  ctx.font = '15px system-ui'
  ctx.fillText('Formes dessinées en JavaScript', 20, 135)
</script>
Aperçu

Définition et utilisation

#

L’élément <canvas> est une toile rectangulaire sur laquelle vous dessinez avec du code JavaScript : formes, graphiques, animations, voire des jeux entiers. Le HTML ne crée qu’une zone vide, et le dessin passe par le contexte obtenu avec la méthode getContext("2d") (ou getContext("webgl") pour les graphismes 3D).

Canvas dessine des pixels, pas des objets. Une fois un cercle dessiné, il n’existe plus d’« élément cercle » que l’on pourrait styler en CSS ou sur lequel on pourrait cliquer : pour l’interaction, c’est à vous de calculer ce que l’utilisateur a touché. Si vous avez besoin de quelques formes redimensionnables, d’icônes ou de schémas, <svg> est généralement un meilleur choix.

La taille de la toile se règle avec les attributs width et height (300 sur 150 pixels par défaut). Le contenu entre les balises est un texte de remplacement : il est utile d’y décrire ce que représente l’image, car le dessin lui-même est invisible pour les lecteurs d’écran.

Syntaxe

#
Syntaxe
<canvas id="canvas" width="300" height="150"></canvas>

Attributs

#
  • width / height

    nombre de pixels (300 et 150 par défaut)

    La largeur et la hauteur de la toile en pixels, c’est-à-dire la résolution du dessin. Si vous agrandissez la toile en CSS sans modifier ces attributs, l’image est étirée et floue, comme dans la partie basse de l’exemple. Modifier ces attributs dans un script efface toute la toile.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

width / height

nombre de pixels (300 et 150 par défaut)

La largeur et la hauteur de la toile en pixels, c’est-à-dire la résolution du dessin. Si vous agrandissez la toile en CSS sans modifier ces attributs, l’image est étirée et floue, comme dans la partie basse de l’exemple. Modifier ces attributs dans un script efface toute la toile.

HTML
<style>
  canvas { display: block; margin-bottom: 8px; }
  .blurry { width: 240px; height: 60px; }
</style>
<canvas class="sharp" width="240" height="60"></canvas>
<canvas class="blurry" width="60" height="15"></canvas>
<script>
  document.querySelectorAll('canvas').forEach((canvas) => {
    const ctx = canvas.getContext('2d')
    ctx.fillStyle = '#a78bfa'
    ctx.font = canvas.height * 0.6 + 'px system-ui'
    ctx.fillText('CodeWorlds', 4, canvas.height * 0.7)
  })
</script>
Aperçu

Plus d’exemples

#
Un graphique à barres simple
HTML
<canvas id="chart" width="320" height="150">
  Graphique de progression : HTML 80 %, CSS 60 %, JavaScript 35 %.
</canvas>
<script>
  const ctx = document.getElementById('chart').getContext('2d')
  const courses = [
    { name: 'HTML', percent: 80, color: '#f97316' },
    { name: 'CSS', percent: 60, color: '#38bdf8' },
    { name: 'JS', percent: 35, color: '#facc15' }
  ]

  ctx.font = '14px system-ui'
  courses.forEach((course, index) => {
    const y = 15 + index * 45
    const width = course.percent * 2.2
    ctx.fillStyle = course.color
    ctx.fillRect(50, y, width, 28)
    ctx.fillStyle = '#e5e7eb'
    ctx.fillText(course.name, 8, y + 19)
    ctx.fillText(course.percent + '%', 58 + width, y + 19)
  })
</script>
Aperçu

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Sur les écrans à haute densité de pixels, le dessin peut paraître légèrement flou. Multipliez width et height par window.devicePixelRatio, laissez la taille CSS inchangée et mettez le contexte à l’échelle avec ctx.scale().
  • Décrivez le contenu de la toile avec un texte de remplacement ou un attribut aria-label avec role="img", afin que l’image ne soit pas un espace vide pour un lecteur d’écran.
  • Pour les animations, utilisez requestAnimationFrame et non setInterval. Le navigateur adapte alors la cadence du dessin au rafraîchissement de l’écran.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.