<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é
Exemple
#<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>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
#<canvas id="canvas" width="300" height="150"></canvas>Attributs
#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.
<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>Plus d’exemples
#<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>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
widthetheightparwindow.devicePixelRatio, laissez la taille CSS inchangée et mettez le contexte à l’échelle avecctx.scale(). - Décrivez le contenu de la toile avec un texte de remplacement ou un attribut
aria-labelavecrole="img", afin que l’image ne soit pas un espace vide pour un lecteur d’écran. - Pour les animations, utilisez
requestAnimationFrameet nonsetInterval. Le navigateur adapte alors la cadence du dessin au rafraîchissement de l’écran.
Entrées associées
#- <svg>Des graphiques vectoriels écrits directement dans le code de la page : icônes, logos, graphiques.
- <img>Une image intégrée à la page.
- <script>Intègre du code JavaScript dans la page ou le charge depuis un fichier pour donner du comportement à la page.
- <figure>Une illustration autonome avec une légende facultative : image, graphique, extrait de code, citation.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.