diff options
Diffstat (limited to 'files/fr/web/api/canvasrenderingcontext2d/clearrect/index.md')
| -rw-r--r-- | files/fr/web/api/canvasrenderingcontext2d/clearrect/index.md | 128 |
1 files changed, 58 insertions, 70 deletions
diff --git a/files/fr/web/api/canvasrenderingcontext2d/clearrect/index.md b/files/fr/web/api/canvasrenderingcontext2d/clearrect/index.md index 7bf854557e..f11c76ec20 100644 --- a/files/fr/web/api/canvasrenderingcontext2d/clearrect/index.md +++ b/files/fr/web/api/canvasrenderingcontext2d/clearrect/index.md @@ -9,46 +9,45 @@ tags: - Reference translation_of: Web/API/CanvasRenderingContext2D/clearRect --- -<div>{{APIRef}}</div> +{{APIRef}} -<p>La méthode <code><strong>CanvasRenderingContext2D</strong></code><strong><code>.clearRect()</code></strong> de l'API 2D des Canvas met en noir transparent tous les pixels dans le rectangle défini par le point de départ de coordonnées <em>(x, y)</em> et par les tailles <em>(largeur, hauteur)</em>, supprimant tout contenu précédemment dessiné.</p> +La méthode **`CanvasRenderingContext2D`\*\***`.clearRect()`\*_ de l'API 2D des Canvas met en noir transparent tous les pixels dans le rectangle défini par le point de départ de coordonnées _(x, y)_ et par les tailles _(largeur, hauteur)\*, supprimant tout contenu précédemment dessiné. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">void <var><em>ctx</em>.clearRect(x, y, largeur, hauteur);</var> -</pre> + void ctx.clearRect(x, y, largeur, hauteur); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>x</code></dt> - <dd>La coordonnée sur l'axe des <em>x</em> du point de départ du rectangle.</dd> - <dt><code>y</code></dt> - <dd>La coordonnée sur l'axe des <em>y</em> du point de départ du rectangle.</dd> - <dt><code>largeur</code></dt> - <dd>La largeur du rectangle.</dd> - <dt><code>hauteur</code></dt> - <dd>La hauteur de rectangle.</dd> -</dl> +- `x` + - : La coordonnée sur l'axe des *x* du point de départ du rectangle. +- `y` + - : La coordonnée sur l'axe des *y* du point de départ du rectangle. +- `largeur` + - : La largeur du rectangle. +- `hauteur` + - : La hauteur de rectangle. -<h2 id="Notes_d'utilisation">Notes d'utilisation</h2> +## Notes d'utilisation -<p>Un problème classique avec <code>clearRect</code> est qu'il peut apparaître comme ne fonctionnant pas si l'on n'<a href="/fr/docs/Tutoriel_canvas/Formes_g%C3%A9om%C3%A9triques#Drawing_paths">utilise pas les trajets de façon appropriée</a>. N'oubliez pas d'appeler {{domxref("CanvasRenderingContext2D.beginPath", "beginPath()")}} avant de commencer à dessiner une nouvelle image après avoir appelé <code>clearRect</code>.</p> +Un problème classique avec `clearRect` est qu'il peut apparaître comme ne fonctionnant pas si l'on n'[utilise pas les trajets de façon appropriée](/fr/docs/Tutoriel_canvas/Formes_g%C3%A9om%C3%A9triques#Drawing_paths). N'oubliez pas d'appeler {{domxref("CanvasRenderingContext2D.beginPath", "beginPath()")}} avant de commencer à dessiner une nouvelle image après avoir appelé `clearRect`. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Utilisation_de_la_méthode_clearRect">Utilisation de la méthode <code>clearRect</code></h3> +### Utilisation de la méthode `clearRect` -<p>Ceci est seulement un fragment de code simple qui utilise la méthode <code>clearRect</code>.</p> +Ceci est seulement un fragment de code simple qui utilise la méthode `clearRect`. -<h4 id="HTML">HTML</h4> +#### HTML -<pre class="brush: html"><canvas id="canvas"></canvas> -</pre> +```html +<canvas id="canvas"></canvas> +``` -<h4 id="JavaScript">JavaScript</h4> +#### JavaScript -<pre class="brush: js">var canevas = document.getElementById("canvas"); +```js +var canevas = document.getElementById("canvas"); var ctx = canevas.getContext("2d"); ctx.beginPath(); @@ -62,18 +61,19 @@ ctx.clearRect(10, 10, 100, 100); // effacer le canevas entièrement // ctx.clearRect(0, 0, canvas.width, canvas.height); -</pre> +``` -<p>Modifiez le code suivant et voyez vos changements en direct dans le canevas :</p> +Modifiez le code suivant et voyez vos changements en direct dans le canevas : -<h4 id="code_jouable">Code jouable</h4> +#### Code jouable -<pre class="brush: html hidden"><canvas id="canvas" width="400" height="200" class="playable-canvas"></canvas> -<div class="playable-buttons"> - <input id="edit" type="button" value="Edit" /> - <input id="reset" type="button" value="Reset" /> -</div> -<textarea id="code" class="playable-code" style="height:140px;"> +```html hidden +<canvas id="canvas" width="400" height="200" class="playable-canvas"></canvas> +<div class="playable-buttons"> + <input id="edit" type="button" value="Edit" /> + <input id="reset" type="button" value="Reset" /> +</div> +<textarea id="code" class="playable-code" style="height:140px;"> ctx.beginPath(); ctx.moveTo(20,20); ctx.lineTo(200,20); @@ -81,10 +81,11 @@ ctx.lineTo(120,120); ctx.closePath(); // dessine la dernière ligne du triangle ctx.stroke(); -ctx.clearRect(10, 10, 100, 100);</textarea> -</pre> +ctx.clearRect(10, 10, 100, 100);</textarea> +``` -<pre class="brush: js hidden">var canvas = document.getElementById("canvas"); +```js hidden +var canvas = document.getElementById("canvas"); var ctx = canvas.getContext("2d"); var textarea = document.getElementById("code"); var reset = document.getElementById("reset"); @@ -107,35 +108,22 @@ edit.addEventListener("click", function() { textarea.addEventListener("input", drawCanvas); window.addEventListener("load", drawCanvas); -</pre> - -<p>{{ EmbedLiveSample('code_jouable', 700, 400) }}</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-clearrect", "CanvasRenderingContext2D.clearRect")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.CanvasRenderingContext2D.clearRect")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>L'interface la définissant, {{domxref("CanvasRenderingContext2D")}}</li> - <li>{{domxref("CanvasRenderingContext2D.fillRect()")}}</li> - <li>{{domxref("CanvasRenderingContext2D.strokeRect()")}}</li> -</ul> +``` + +{{ EmbedLiveSample('code_jouable', 700, 400) }} + +## Spécifications + +| Spécification | Statut | Commentaire | +| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------- | +| {{SpecName('HTML WHATWG', "scripting.html#dom-context-2d-clearrect", "CanvasRenderingContext2D.clearRect")}} | {{Spec2('HTML WHATWG')}} | | + +## Compatibilité des navigateurs + +{{Compat("api.CanvasRenderingContext2D.clearRect")}} + +## Voir aussi + +- L'interface la définissant, {{domxref("CanvasRenderingContext2D")}} +- {{domxref("CanvasRenderingContext2D.fillRect()")}} +- {{domxref("CanvasRenderingContext2D.strokeRect()")}} |