--- title: CanvasRenderingContext2D.save() slug: Web/API/CanvasRenderingContext2D/save tags: - API - Canvas - CanvasRenderingContext2D - Restaurer - Save translation_of: Web/API/CanvasRenderingContext2D/save --- <div>{{APIRef}}</div> <p>La méthode <code><strong>CanvasRenderingContext2D</strong></code><strong><code>.save()</code></strong> de l'API Canvas 2D API enregistre l'état complet du canvas en plaçant l'état courant dans une stack.</p> <h3 id="Létat_du_dessin">L'état du dessin</h3> <p>L'état du dessin qui est sauvegardé dans une stack se compose de:</p> <ul> <li>La matrice de transformation actuelle.</li> <li>La région de détourage actuelle.</li> <li>Le tableau pour les tracés en pointillés.</li> <li>Les valeurs des attributs suivant: {{domxref("CanvasRenderingContext2D.strokeStyle", "strokeStyle")}}, {{domxref("CanvasRenderingContext2D.fillStyle", "fillStyle")}}, {{domxref("CanvasRenderingContext2D.globalAlpha", "globalAlpha")}}, {{domxref("CanvasRenderingContext2D.lineWidth", "lineWidth")}}, {{domxref("CanvasRenderingContext2D.lineCap", "lineCap")}}, {{domxref("CanvasRenderingContext2D.lineJoin", "lineJoin")}}, {{domxref("CanvasRenderingContext2D.miterLimit", "miterLimit")}}, {{domxref("CanvasRenderingContext2D.lineDashOffset", "lineDashOffset")}}, {{domxref("CanvasRenderingContext2D.shadowOffsetX", "shadowOffsetX")}}, {{domxref("CanvasRenderingContext2D.shadowOffsetY", "shadowOffsetY")}}, {{domxref("CanvasRenderingContext2D.shadowBlur", "shadowBlur")}}, {{domxref("CanvasRenderingContext2D.shadowColor", "shadowColor")}}, {{domxref("CanvasRenderingContext2D.globalCompositeOperation", "globalCompositeOperation")}}, {{domxref("CanvasRenderingContext2D.font", "font")}}, {{domxref("CanvasRenderingContext2D.textAlign", "textAlign")}}, {{domxref("CanvasRenderingContext2D.textBaseline", "textBaseline")}}, {{domxref("CanvasRenderingContext2D.direction", "direction")}}, {{domxref("CanvasRenderingContext2D.imageSmoothingEnabled", "imageSmoothingEnabled")}}.</li> </ul> <h2 id="Syntaxe">Syntaxe</h2> <pre class="syntaxbox">void <em>ctx</em>.save();</pre> <h2 id="Exemple">Exemple</h2> <h3 id="Enregistrer_létat_du_dessin">Enregistrer l'état du dessin</h3> <p>Cet exemple utilise la méthode <code>save()</code> pour enregistrer l'état par défaut et <code>restore()</code> pour le rétablir plus tard, on pourra ainsi dessiner un rectangle avec l'état de base après.</p> <h4 id="HTML">HTML</h4> <pre class="brush: html"><canvas id="canvas"></canvas> </pre> <h4 id="JavaScript">JavaScript</h4> <pre class="brush: js; highlight:[5]">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); </pre> <h4 id="Résultat">Résultat</h4> <p>{{ EmbedLiveSample('Saving_the_drawing_state', 700, 180) }}</p> <h2 id="Spécifications">Spécifications</h2> <table class="standard-table"> <tbody> <tr> <th scope="col">Spécification</th> <th scope="col">Statut</th> <th scope="col">Commentaire</th> </tr> <tr> <td>{{SpecName('HTML WHATWG', "scripting.html#dom-context-2d-save", "CanvasRenderingContext2D.save")}}</td> <td>{{Spec2('HTML WHATWG')}}</td> <td></td> </tr> </tbody> </table> <h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> <p>{{Compat("api.CanvasRenderingContext2D.save")}}</p> <h2 id="Voir_aussi">Voir aussi</h2> <ul> <li>L'interface définissant cette méthode: {{domxref("CanvasRenderingContext2D")}}</li> <li>{{domxref("CanvasRenderingContext2D.restore()")}}</li> </ul>