From a47584de1bd47788cb5aa6178fa88b31977b2a8e Mon Sep 17 00:00:00 2001 From: tristantheb Date: Sat, 19 Jun 2021 10:25:05 +0200 Subject: UPDATE: Update translation of the HTML elements — 🛠 Priority work area (#500) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * UPDATE: Updating pages starting with A * FIX: Update missing KS to html anchor * Review HTML Element a * Review HTML Element abbr * Review HTML Element acronym * Review HTML Element address * Review HTML Element applet * Review HTML Element area * Review HTML Element article * Review HTML Element aside * Review HTML Element audio * UPDATE: Updating pages wtarting with B * Review HTML Element b * Review HTML Element base * Review HTML Element basefont * Review HTML Element bdi * Review HTML Element bdo * Review HTML Element big * Review HTML Element blink * Review HTML Element blockquote * Review HTML Element body * Review HTML Element br * Review HTML Element button * Review HTML Element button - rm HTMLRef * Review HTML Element button - lint link * UPDATE: Updating pages starting with C * UPDATE: Updating pages starting with D * UPDATE: Refresh the reference page * UPDATE: Updating pages starting with E * Review HTML Element canvas * Review HTML Element caption * Review HTML Element center * Review HTML Element cite * UPDATE: Updating pages starting with F * BCD: Update all updated pages with new BCD format * FIX: add missing bracket * Review - HTML element - code * Review - HTML Element - col * Review - HTML Element - colgroup * Review - HTML Element - content * Review - HTML Element - data * Review - HTML Element - datalist * Review - HTML Element - dd * Review - HTML Element - del * Review - HTML Element * Review - HTML Element - dfn * Review - HTML Element - dialog * Review - HTML element - dir * Review - HTML Element div * Review - HTML Element - dl * Review - HTML Element - dt * Review - HTML Element - em * Review - HTML Element - embed * Review - HTML Element - fieldset * Review - HTML Element - figcaption * Review - HTML Element - figure * Review - HTML Element - font * Review - HTML Element - footer * Review - HTML Element - form * Review - HTML Element - frame * Review - HTML Element - frameset * Review updates since PR start - A * Review updates since PR start - B * Review updates since PR start - C * Review updates since PR start - D * Review updates since PR start - F Co-authored-by: julieng --- files/fr/web/html/element/canvas/index.html | 256 +++++++++++++--------------- 1 file changed, 115 insertions(+), 141 deletions(-) (limited to 'files/fr/web/html/element/canvas') diff --git a/files/fr/web/html/element/canvas/index.html b/files/fr/web/html/element/canvas/index.html index 94ace3eeae..be7e12369b 100644 --- a/files/fr/web/html/element/canvas/index.html +++ b/files/fr/web/html/element/canvas/index.html @@ -5,202 +5,176 @@ tags: - Canvas - Element - HTML + - HTML scripting + - HTML5 - Reference - Web translation_of: Web/HTML/Element/canvas +browser-compat: html.elements.canvas ---
{{HTMLRef}}
-

L'élément <canvas> permet de modifier une zone graphique via un script (habituellement en JavaScript ou grâce à WebGL). Il peut par exemple être utilisé afin de dessiner des graphiques, manipuler des images ou jouer des animations.

+

On utilise l'élément HTML <canvas> avec l'API canvas, ou l'API WebGL pour dessiner des graphiques et des animations.

-

Pour plus d'information sur l'élément <canvas>, voir la page sur canvas.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Catégories de contenuContenu de flux, contenu phrasé, contenu intégré, contenu tangible.
Contenu autoriséTransparent mais sans aucun descendant étant du contenu interactif à l'exception des éléments <a>, <button>, <input> dont l'attribut type vaut checkbox, radio, ou button.
Omission de balisesAucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisésTout contenu acceptant du contenu phrasé.
RĂ´le ARIA implicitePas de rĂ´le correspondant
Rôles ARIA autorisésTous les rôles sont autorisés
Interface DOMHTMLCanvasElement
-

Attributs

+

Attributs

-

Comme les autres éléments HTML, cet élément possède les attributs globaux.

+

Comme les autres éléments HTML, cet élément possède les attributs globaux.

-
{{htmlattrdef("height")}}
-
La hauteur de l'espace pour l'élément, exprimée en pixels CSS. La valeur par défaut est 150.
-
{{htmlattrdef("moz-opaque")}} {{non-standard_inline}}
-
Cet attribut permet d'indiquer s'il y aura de la transparence ou non. Si le canevas sait qu'il n'y aura pas de transparence, les performances de rendu pourront être améliorées. Cet attribut est uniquement pris en charge par les navigateurs Mozilla, il est préférable d'utiliser la méthode standard {{domxref("HTMLCanvasElement.getContext()", "canvas.getContext('2d', { alpha: false})")}} à la place.
-
{{htmlattrdef("width")}}
-
La largeur de l'espace pour l'élément, exprimée en pixels CSS. La valeur par défaut est 300.
+
height
+
La hauteur de l'espace pour l'élément, exprimée en pixels CSS. La valeur par défaut est 150.
+
moz-opaque {{non-standard_inline}}{{deprecated_inline}}
+
Cet attribut permet d'indiquer s'il y aura de la transparence ou non. Si le canevas sait qu'il n'y aura pas de transparence, les performances de rendu pourront être améliorées. Cet attribut est uniquement pris en charge par les navigateurs Mozilla, il est préférable d'utiliser la méthode standard canvas.getContext('2d', { alpha: false}) à la place.
+
width
+
La largeur de l'espace pour l'élément, exprimée en pixels CSS. La valeur par défaut est 300.
-

Notes d'utilisation

+

Notes d'utilisation

-

Contenu alternatif

+

Contenu alternatif

-

Il est fortement recommandé de fournir un contenu alternatif au contenu du bloc <canvas>. Ce contenu pourra être utilisé par les navigateurs plus anciens qui ne supportent pas l'élément <canvas> et ceux pour lesquels JavaScript est désactivé.

+

Il est fortement recommandé de fournir un contenu alternatif au contenu du bloc <canvas>. Ce contenu pourra être utilisé par les navigateurs plus anciens qui ne supportent pas l'élément <canvas> et ceux pour lesquels JavaScript est désactivé. Fournir un texte de repli ou un sous-DOM utile aide à rendre le canevas plus accessible.

-

Balise </canvas> obligatoire

+

Balise </canvas> obligatoire

-

À la différence de {{HTMLElement("img")}}, l'élément {{HTMLElement("canvas")}} doit être fermé avec la balise fermante </canvas>.

+

À la différence de <img>, l'élément <canvas> doit être fermé avec la balise fermante </canvas>.

-

Dimensionnement du canevas : CSS ou HTML

+

Dimensionnement du canevas : CSS ou HTML

On peut modifier la taille affichée du canevas grâce à une feuille de style. L'image est mise à l'échelle lors du rendu pour correspondre à la taille indiquée par le style. Toutefois, cela pourra distordre l'image lors du rendu final.

Mieux vaut utiliser les attributs explicites width et height de l'élément en HTML (ou via du code JavaScript).

-

Taille maximale d'un canevas

+

Taille maximale d'un canevas

La taille maximale d'un élément <canvas> dépend du navigateur utilisé. Voici un tableau de mesures provenant de tests et diverses sources (ex. Stack Overflow):

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NavigateurHauteur maximaleLargeur maximaleAire maximale
Chrome32 767 pixels32 767 pixels268 435 456 pixels (soit 16 384 x 16 384)
Firefox32 767 pixels32 767 pixels472 907 776 pixels (soit 22 528 x 20 992)
Safari32 767 pixels32 767 pixels268 435 456 pixels (soit 16 384 x 16 384)
IE8 192 pixels8 192 pixels?
NavigateurHauteur maximaleLargeur maximaleAire maximale
Chrome32 767 pixels32 767 pixels268 435 456 pixels (soit 16 384 x 16 384)
Firefox32 767 pixels32 767 pixels472 907 776 pixels (soit 22 528 x 20 992)
Safari32 767 pixels32 767 pixels268 435 456 pixels (soit 16 384 x 16 384)
IE8 192 pixels8 192 pixels?
-
-

Note : Si on dépasse les dimensions ou l'aire maximale, le canevas deviendra inutilisable et les commandes de dessin ne fonctionneront pas.

+
+

Note :

+

Si on dépasse les dimensions ou l'aire maximale, le canevas deviendra inutilisable et les commandes de dessin ne fonctionneront pas.

-

Exemples

+

Exemples

-

HTML

+

HTML

Le fragment de code suivant ajoute un élément canvas au document. Un texte alternatif est fourni au cas où le navigateur ne peut pas afficher ce canevas. Un texte alternatif ou bien des éléments internes permettront de rendre le canevas plus accessible.

-
<canvas id="canvas" width="300" height="300">
+
<canvas width="300" height="100">
   Désolé, votre navigateur ne prend pas en charge &lt;canvas&gt;.
-</canvas>
-
+</canvas>
-

JavaScript

+

JavaScript

-

On utilise également ce fragment de code JavaScript avec la méthode {{domxref("HTMLCanvasElement.getContext()")}} afin d'obtenir le contexte de dessin puis on dessine sur le canevas.

+

On utilise également ce fragment de code JavaScript avec la méthode HTMLCanvasElement.getContext() afin d'obtenir le contexte de dessin puis on dessine sur le canevas.

-
var canvas = document.getElementById('canvas');
+
var canvas = document.querySelector('canvas');
 var ctx = canvas.getContext('2d');
 ctx.fillStyle = 'green';
 ctx.fillRect(10, 10, 100, 100);
-

Gérer l'opacité

- -

Si le canevas n'utilise pas la transparence, on pourra indiquer au navigateur que le canevas est opaque afin d'optimiser le rendu. Pour cela, on pourra utiliser la propriété alpha avec la valeur false.

- -
var canvas = document.getElementById('canvas');
-var ctx = canvas.getContext('2d', {alpha: false});
+

Résultat

-

Avant que cette option soit standard, on pouvait utiliser l'attribut HTML moz-opaque {{non-standard_inline}} {{deprecated_inline}} pour les navigateurs basés sur Gecko. Toutefois, ce n'est pas une solution standard, cf. le bug {{bug(878155)}} pour suivre le retrait de cet attribut.

+

{{EmbedLiveSample('examples')}}

-

Résultat

+

Accessibilité

-

{{EmbedLiveSample("Exemples","300","300")}}

+

Contenu alternatif

-

Accessibilité

- -

Contenu alternatif

- -

Seul, l'élément <canvas> est une image matricielle et ne fournit pas d'informations sur les objets dessinés. Le contenu d'un canevas n'est pas accessible aux outils d'assistance qui se basent sur le contenu sémantique du document HTML. De façon générale, on évitera de se servir uniquement de <canvas> pour produire un document accessible.

+

Seul, l'élément <canvas> est une image matricielle et ne fournit pas d'informations sur les objets dessinés. Le contenu d'un canevas n'est pas accessible aux outils d'assistance qui se basent sur le contenu sémantique du document HTML. De façon générale, on évitera de se servir uniquement de <canvas> pour produire un document accessible. Voici quelques pages et articles pour aider à l'accessibilité avec les canevas :

-

Résumé technique

- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Catégories de contenuContenu de flux, contenu phrasé, contenu intégré, contenu tangible.
Contenu autoriséTransparent mais sans aucun descendant étant du contenu interactif à l'exception des éléments {{HTMLElement("a")}}, {{HTMLElement("button")}}, {{HTMLElement("input")}} dont l'attribut {{htmlattrxref("type", "input")}} vaut checkbox, radio, ou button.
Omission de balises{{no_tag_omission}}
Parents autorisésTout contenu acceptant du contenu phrasé.
Rôles ARIA autorisésTous les rôles sont autorisés
Interface DOM{{domxref("HTMLCanvasElement")}}
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', 'scripting.html#the-canvas-element', '<canvas>')}}{{Spec2('HTML WHATWG')}} 
{{SpecName('HTML5 W3C', 'scripting-1.html#the-canvas-element', '<canvas>')}}{{Spec2('HTML5 W3C')}} 
+

Spécifications

-

Compatibilité des navigateurs

+

{{Specifications}}

- +

Compatibilité des navigateurs

-

{{Compat("html.elements.canvas")}}

+

{{Compat}}

-

Voir aussi

+

Voir aussi

-- cgit v1.2.3-54-g00ecf