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
js
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
html
<canvas id="canvas"></canvas>
JavaScript
js
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
Voir aussi
- L'interface définissant cette méthode :
CanvasRenderingContext2D CanvasRenderingContext2D.restore()