Aller au contenu

Référence Canvas

L'élément HTML5 <canvas> est utilisé pour dessiner des graphiques via un script (généralement JavaScript). Cependant, l'élément <canvas> ne propose pas de fonctionnalités de dessin par lui-même. Pour dessiner des graphiques, vous devez utiliser un script, car l'élément <canvas> n'est qu'un conteneur pour les graphiques.

La méthode getContext() renvoie un objet qui expose des propriétés et des méthodes pour dessiner sur le canevas.

Couleurs, Styles et Ombres

PropertyDescription
fillStyleDéfinit ou renvoie la couleur, le dégradé ou le motif utilisé pour remplir les formes.
strokeStyleDéfinit ou renvoie la couleur, le dégradé ou le motif utilisé pour les contours des formes.
shadowColorDéfinit ou renvoie la couleur des ombres.
shadowBlurDéfinit ou renvoie le niveau de flou des ombres.
shadowOffsetXDéfinit ou renvoie le décalage x de l'ombre.
shadowOffsetYDéfinit ou renvoie le décalage y de l'ombre.
MethodDescription
createLinearGradient()Crée un dégradé linéaire à utiliser sur le contenu du canevas.
createPattern()Répète un élément spécifique dans la direction indiquée.
createRadialGradient()Crée un dégradé circulaire/radial à utiliser sur le contenu du canevas.
addColorStop()Définit les couleurs et les positions d'arrêt dans l'objet dégradé.

Styles de Ligne

PropertyDescription
lineCapDéfinit ou renvoie le style des extrémités de la ligne.
lineJoinDéfinit ou renvoie le type des coins tracés.
lineWidthDéfinit ou renvoie la largeur de la ligne actuelle.
miterLimitDéfinit ou renvoie la longueur maximale de l'onglet.
lineDashDéfinit ou renvoie un tableau de nombres spécifiant les motifs de tirets.
lineDashOffsetDéfinit ou renvoie le décalage pour les motifs de tirets.

Rectangles

MethodDescription
rect()Crée des rectangles.
fillRect()Dessine des rectangles remplis.
strokeRect()Dessine des contours rectangulaires.
clearRect()Efface les pixels spécifiés à l'intérieur d'un rectangle donné.

Chemins

MethodDescription
fill()Remplit le(s) sous-chemin(s) actuel(s) avec le fillStyle actuel.
stroke()Trace le(s) sous-chemin(s) actuel(s) avec le strokeStyle actuel.
beginPath()Démarre un nouveau chemin ou réinitialise le chemin actuel.
moveTo()Déplace le chemin vers le point défini dans le canevas sans tracer de ligne.
closePath()Ajoute un chemin du point actuel au point de départ.
lineTo()Ajoute une ligne au sous-chemin actuel.
clip()Crée une zone de découpage à partir du chemin actuel.
quadraticCurveTo()Ajoute une courbe de Bézier quadratique.
bezierCurveTo()Ajoute une courbe de Bézier cubique.
arc()Ajoute un arc/courbe pour créer des cercles ou des parties de cercles.
arcTo()Ajoute un arc/courbe entre deux tangentes.
isPointInPath()Définit si le point spécifié se trouve dans le chemin actuel ou non.

Transformations

MethodDescription
scale()Agrandit ou réduit le dessin actuel.
rotate()Fait pivoter le dessin actuel.
translate()Ajuste le système de coordonnées du canevas.
transform()Applique une matrice de transformation au canevas.
setTransform()Similaire à transform(). Peut être utilisé pour incliner, mettre à l'échelle et translater le canevas.

Texte

PropertyDescription
fontDéfinit l'apparence du texte dessiné sur le canevas.
textAlignDéfinit l'alignement du texte dessiné sur le canevas.
textBaselineDéfinit l'alignement vertical du texte dessiné sur le canevas.
MethodDescription
fillText()Ajoute du texte au canevas.
strokeText()Ajoute du texte en contour au canevas.
measureText()Mesure la largeur du texte.

Dessin d'Images

MethodDescription
drawImage()Dessine une image, une vidéo ou un canevas sur le canevas.

Manipulation de Pixels

PropertyDescription
widthRenvoie la largeur d'un objet ImageData.
heightRenvoie la hauteur d'un objet ImageData.
dataRenvoie un Uint8ClampedArray contenant les données des pixels.
MethodDescription
createImageData()Crée un nouvel objet ImageData.
getImageData()Renvoie un objet ImageData qui copie les données des pixels pour le rectangle spécifié.
putImageData()Place les données de l'image sur le canevas à partir de l'objet ImageData.

Composition

PropertyDescription
globalAlphaDéfinit ou renvoie la valeur alpha/transparence actuelle.
globalCompositeOperationDéfinit ou renvoie le type d'opération de composition lors du dessin d'une nouvelle image.

Autres

MethodDescription
save()Enregistre l'état actuel d'un contexte.
restore()Restaure l'état du chemin et les attributs enregistrés précédemment.

Remarque : getContext() et toDataURL() sont des méthodes de l'élément <canvas> lui-même, et non du contexte de dessin.

Pratique

Que peut faire la méthode getContext('2d') dans le Canvas HTML5 ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.