CanvasRenderingContext2D.save()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
La méthode CanvasRenderingContext2D.save()
de l'API Canvas 2D API enregistre l'état complet du canvas en plaçant l'état courant dans une stack.
L'état du dessin
L'état du dessin qui est sauvegardé dans une stack se compose de :
- La matrice de transformation actuelle.
- La région de détourage actuelle.
- Le tableau pour les tracés en pointillés.
- Les valeurs des attributs suivant :
strokeStyle
,fillStyle
,globalAlpha
,lineWidth
,lineCap
,lineJoin
,miterLimit
,lineDashOffset
,shadowOffsetX
,shadowOffsetY
,shadowBlur
,shadowColor
,globalCompositeOperation
,font
,textAlign
,textBaseline
,direction
,imageSmoothingEnabled
.
Syntaxe
void ctx.save();
Exemples
Enregistrer l'état du dessin
Cet exemple utilise la méthode save()
pour enregistrer l'état par défaut et restore()
pour le rétablir plus tard, on pourra ainsi dessiner un rectangle avec l'état de base après.
HTML
<canvas id="canvas"></canvas>
JavaScript
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
// On sauvegarde l'état par défaut
ctx.save();
ctx.fillStyle = "green";
ctx.fillRect(10, 10, 100, 100);
// On restaure l'état par défaut
ctx.restore();
ctx.fillRect(150, 40, 100, 100);
Résultat
Spécifications
Specification |
---|
HTML # dom-context-2d-save-dev |
Compatibilité des navigateurs
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
save |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
Voir aussi
- L'interface définissant cette méthode :
CanvasRenderingContext2D
CanvasRenderingContext2D.restore()