diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-13 07:13:08 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-11-07 11:56:53 +0100 |
commit | dea9d1f019d9e14357c58cf18653df1ac779d9d8 (patch) | |
tree | d20318111821d4e935a6c53409240078c4f687e5 /files/fr/web/html/element/source | |
parent | 8829a7c9eb82f180bac76ed5836aaef95be209a1 (diff) | |
download | translated-content-dea9d1f019d9e14357c58cf18653df1ac779d9d8.tar.gz translated-content-dea9d1f019d9e14357c58cf18653df1ac779d9d8.tar.bz2 translated-content-dea9d1f019d9e14357c58cf18653df1ac779d9d8.zip |
convert content to md
Diffstat (limited to 'files/fr/web/html/element/source')
-rw-r--r-- | files/fr/web/html/element/source/index.md | 210 |
1 files changed, 106 insertions, 104 deletions
diff --git a/files/fr/web/html/element/source/index.md b/files/fr/web/html/element/source/index.md index 31882e6eed..bbd033ba30 100644 --- a/files/fr/web/html/element/source/index.md +++ b/files/fr/web/html/element/source/index.md @@ -9,134 +9,136 @@ tags: - Web translation_of: Web/HTML/Element/source --- -<div>{{HTMLRef}}</div> +{{HTMLRef}} -<p>L'élément HTML <strong><code><source></code></strong> définit différentes ressources média pour un élément {{HTMLElement("picture")}}, {{HTMLElement("audio")}} ou {{HTMLElement("video")}}. C'est un élément vide : il ne possède pas de contenu et ne nécessite pas de balise fermante. Il est généralement utilisé pour distribuer le même contenu en utilisant <a href="/fr/docs/Web/HTML/formats_media_support">les différents formats pris en charge par les différents navigateurs</a>.</p> +L'élément HTML **`<source>`** définit différentes ressources média pour un élément {{HTMLElement("picture")}}, {{HTMLElement("audio")}} ou {{HTMLElement("video")}}. C'est un élément vide : il ne possède pas de contenu et ne nécessite pas de balise fermante. Il est généralement utilisé pour distribuer le même contenu en utilisant [les différents formats pris en charge par les différents navigateurs](/fr/docs/Web/HTML/formats_media_support). -<div>{{EmbedInteractiveExample("pages/tabbed/source.html", "tabbed-standard")}}</div> +{{EmbedInteractiveExample("pages/tabbed/source.html", "tabbed-standard")}} -<h2 id="Attributs">Attributs</h2> +## Attributs -<p>Cet élément inclut <a href="/fr/docs/Web/HTML/Attributs_universels">les attributs universels</a>.</p> +Cet élément inclut [les attributs universels](/fr/docs/Web/HTML/Attributs_universels). -<dl> - <dt>{{htmlattrdef("media")}}</dt> - <dd><a href="/fr/docs/Web/CSS/Requêtes_média/Utiliser_les_Media_queries">Une requête média</a> pour sélectionner la source du média. Cet attribut doit uniquement être utilisé pour un élément {{HTMLElement("picture")}}.</dd> - <dt>{{htmlattrdef("sizes")}}</dt> - <dd>Cet attribut est une liste de chaîne de caractères, séparées par des virgules, dont chacune décrit une condition de taille. Cette information est utilisée par le navigateur, avant la disposition de la page, pour déterminer quelle image parmi celles définies via l'attribut {{htmlattrxref("srcset", "source")}}. Cet attribut aura un effet uniquement lorsque l'élément {{HTMLElement("source")}} est un élément fils direct d'un élément {{HTMLElement("picture")}}.</dd> - <dt>{{htmlattrdef("src")}}</dt> - <dd>Cet attribut est obligatoire pour les éléments {{HTMLElement("audio")}} et {{HTMLElement("video")}}. Il définit l'adresse de la ressource. La valeur de cet attribut est ignorée lorsque l'élément <code><source></code> est à l'intérieur d'un élément{{HTMLElement("picture")}}.</dd> - <dt>{{htmlattrdef("srcset")}}</dt> - <dd>Une liste d'une ou plusieurs chaînes de caractères, séparées par des virgules. Cette liste indique un ensemble d'images qui peuvent être utilisées comme sources par le navigateur. Chaque chaîne de caractères se compose : - <ol> - <li>D'une URL pointant vers l'image,</li> - <li>D'un descripteur de largeur, c'est un entier positif, directement suivi par <code>'w'</code>. La valeur par défaut, si ce descripteur est absent, correspond à l'infini positif.</li> - <li>D'un descripteur de densité de pixel, c'est un nombre décimal positif, directement suivi par <code>'x'</code>. La valeur par défaut, si ce descripteur est absent, est <code>1x</code>.</li> - </ol> +- {{htmlattrdef("media")}} + - : [Une requête média](/fr/docs/Web/CSS/Requêtes_média/Utiliser_les_Media_queries) pour sélectionner la source du média. Cet attribut doit uniquement être utilisé pour un élément {{HTMLElement("picture")}}. +- {{htmlattrdef("sizes")}} + - : Cet attribut est une liste de chaîne de caractères, séparées par des virgules, dont chacune décrit une condition de taille. Cette information est utilisée par le navigateur, avant la disposition de la page, pour déterminer quelle image parmi celles définies via l'attribut {{htmlattrxref("srcset", "source")}}. Cet attribut aura un effet uniquement lorsque l'élément {{HTMLElement("source")}} est un élément fils direct d'un élément {{HTMLElement("picture")}}. +- {{htmlattrdef("src")}} + - : Cet attribut est obligatoire pour les éléments {{HTMLElement("audio")}} et {{HTMLElement("video")}}. Il définit l'adresse de la ressource. La valeur de cet attribut est ignorée lorsque l'élément `<source>` est à l'intérieur d'un élément{{HTMLElement("picture")}}. +- {{htmlattrdef("srcset")}} - <p>Pour être valide, chaque chaîne de caractères doit comporter au moins un descripteur de largeur ou un descripteur de densité de pixel. Dans cette liste, il ne peut y avoir qu'une seule chaîne pour un même couple de descripteurs largeur/pixels. Le navigateur choisira la meilleure image parmi celles fournies dans la liste.<br> - L'attribut <code>srcset</code> n'aura un effet que lorsque l'élément {{HTMLElement("source")}} est le fils direct de l'élément {{HTMLElement("picture")}}.</p> - </dd> - <dt>{{htmlattrdef("type")}}</dt> - <dd>Le type MIME de la ressource, éventuellement complété d'un paramètre <code>codecs</code>. <a class="external" href="https://tools.ietf.org/html/rfc4281">La RFC 4281</a> indique comment indiquer des codecs. Si l'attribut <code>type</code> n'est pas défini, le type de média est récupéré depuis le serveur et le navigateur vérifie s'il peut le gérer. Si le fichier ne peut être utilisé, la source suivante est contrôlée et ainsi de suite. Si l'attribut <code>type</code> est indiqué, le navigateur le compare avec la liste des types qu'il prend en charge, si le type n'est pas reconnu, le serveur n'est pas interrogé et le navigateur analyse l'élément <code><source></code> qui suit.</dd> -</dl> + - : Une liste d'une ou plusieurs chaînes de caractères, séparées par des virgules. Cette liste indique un ensemble d'images qui peuvent être utilisées comme sources par le navigateur. Chaque chaîne de caractères se compose : -<h2 id="Notes_d'utilisation">Notes d'utilisation</h2> + 1. D'une URL pointant vers l'image, + 2. D'un descripteur de largeur, c'est un entier positif, directement suivi par `'w'`. La valeur par défaut, si ce descripteur est absent, correspond à l'infini positif. + 3. D'un descripteur de densité de pixel, c'est un nombre décimal positif, directement suivi par `'x'`. La valeur par défaut, si ce descripteur est absent, est `1x`. -<p>L'élément <code><source></code> est un <em>élément vide</em> ce qui signifie qu'il n'a aucun contenu et qu'il n'y a pas de balise fermante associée. Autrement dit, on n'utilisera pas <code></source></code> dans le code d'un document HTML.</p> + Pour être valide, chaque chaîne de caractères doit comporter au moins un descripteur de largeur ou un descripteur de densité de pixel. Dans cette liste, il ne peut y avoir qu'une seule chaîne pour un même couple de descripteurs largeur/pixels. Le navigateur choisira la meilleure image parmi celles fournies dans la liste. + L'attribut `srcset` n'aura un effet que lorsque l'élément {{HTMLElement("source")}} est le fils direct de l'élément {{HTMLElement("picture")}}. -<h2 id="Exemples">Exemples</h2> +- {{htmlattrdef("type")}} + - : Le type MIME de la ressource, éventuellement complété d'un paramètre `codecs`. [La RFC 4281](https://tools.ietf.org/html/rfc4281) indique comment indiquer des codecs. Si l'attribut `type` n'est pas défini, le type de média est récupéré depuis le serveur et le navigateur vérifie s'il peut le gérer. Si le fichier ne peut être utilisé, la source suivante est contrôlée et ainsi de suite. Si l'attribut `type` est indiqué, le navigateur le compare avec la liste des types qu'il prend en charge, si le type n'est pas reconnu, le serveur n'est pas interrogé et le navigateur analyse l'élément `<source>` qui suit. -<h3 id="Vidéo">Vidéo</h3> +## Notes d'utilisation -<p>Dans cet exemple, on voit comment distribuer une vidéo au format Ogg pour les navigateurs qui prennent en charge ce format, la même vidéo au format QuickTime pour d'autres voire au format webm. Si le navigateur ne prend pas en charge <code><audio></code> ou <code><video></code>, un message sera affiché. Si le navigateur prend en charge l'élément mais aucun des formats proposé, un évènement <code>error</code> sera déclenché et le lecteur média (s'il est activé) indiquera une erreur. <a href="/fr/docs/Web/HTML/formats_media_support">Cette page indique les différents formats pris en charge par les navigateurs</a> pour les éléments <code><audio></code> et <code><video></code>.</p> +L'élément `<source>` est un _élément vide_ ce qui signifie qu'il n'a aucun contenu et qu'il n'y a pas de balise fermante associée. Autrement dit, on n'utilisera pas `</source>` dans le code d'un document HTML. -<h4 id="HTML">HTML</h4> +## Exemples -<pre class="brush: html"><video controls> - <source src="toto.webm" type="video/webm"> - <source src="toto.ogg" type="video/ogg"> - <source src="toto.mov" type="video/quicktime"> +### Vidéo + +Dans cet exemple, on voit comment distribuer une vidéo au format Ogg pour les navigateurs qui prennent en charge ce format, la même vidéo au format QuickTime pour d'autres voire au format webm. Si le navigateur ne prend pas en charge `<audio>` ou `<video>`, un message sera affiché. Si le navigateur prend en charge l'élément mais aucun des formats proposé, un évènement `error` sera déclenché et le lecteur média (s'il est activé) indiquera une erreur. [Cette page indique les différents formats pris en charge par les navigateurs](/fr/docs/Web/HTML/formats_media_support) pour les éléments `<audio>` et `<video>`. + +#### HTML + +```html +<video controls> + <source src="toto.webm" type="video/webm"> + <source src="toto.ogg" type="video/ogg"> + <source src="toto.mov" type="video/quicktime"> Votre navigateur ne prend pas en charge audio ou video. -</video> -</pre> +</video> +``` -<p>Pour plus d'exemples, se référer à <a href="/fr/docs/Web/HTML/Utilisation_d'audio_et_video_en_HTML5">Manipuler les éléments <code><audio></code> et <code><video></code> dans Firefox</a>.</p> +Pour plus d'exemples, se référer à [Manipuler les éléments `<audio>` et `<video>` dans Firefox](/fr/docs/Web/HTML/Utilisation_d'audio_et_video_en_HTML5). -<h3 id="Image">Image</h3> +### Image -<pre class="brush: html"><picture> - <source srcset="mdn-logo-wide.png" media="(min-width: 800px)"> - <source srcset="mdn-logo-medium.png" media="(min-width: 600px)"> - <img src="mdn-logo-narrow.png" alt="MDN"> -</picture> -</pre> +```html +<picture> + <source srcset="mdn-logo-wide.png" media="(min-width: 800px)"> + <source srcset="mdn-logo-medium.png" media="(min-width: 600px)"> + <img src="mdn-logo-narrow.png" alt="MDN"> +</picture> +``` -<p>Avec l'élément {{HTMLElement("picture")}}, il faut toujours inclure un élément {{HTMLElement("img")}} comme image de secours, avec un attribut <code>alt</code> qui garantit une certaine accessibilité.</p> +Avec l'élément {{HTMLElement("picture")}}, il faut toujours inclure un élément {{HTMLElement("img")}} comme image de secours, avec un attribut `alt` qui garantit une certaine accessibilité. -<h2 id="Résumé_technique">Résumé technique</h2> +## Résumé technique <table class="properties"> - <tbody> - <tr> - <th scope="row"><a href="/fr/docs/Web/HTML/Catégorie_de_contenu">Catégories de contenu</a></th> - <td>Aucune.</td> - </tr> - <tr> - <th scope="row">Contenu autorisé</th> - <td>Aucun, c'est un élément vide.</td> - </tr> - <tr> - <th scope="row">Omission de balises</th> - <td>Cet élément doit avoir une balise ouvrante mais pas de balise fermante.</td> - </tr> - <tr> - <th scope="row"><dfn>Parents autorisés</dfn></th> - <td> - <div>Un élément média —{{HTMLElement("audio")}} ou {{HTMLelement("video")}}— pour lequel l'élément <code><source></code> doit être placé avant <a href="/fr/docs/Web/HTML/Catégorie_de_contenu#Contenu_de_flux">tout contenu de flux</a> ou tout élément {{HTMLElement("track")}}.</div> - - <div>Un élément {{HTMLElement("picture")}}, pour lequel l'élément <code><source></code> doit être placé avant tout élément {{HTMLElement("img")}}.</div> - </td> - </tr> - <tr> - <th scope="row">Rôles ARIA autorisés</th> - <td>Aucun.</td> - </tr> - <tr> - <th scope="row">Interface DOM</th> - <td>{{domxref("HTMLSourceElement")}}</td> - </tr> - </tbody> + <tbody> + <tr> + <th scope="row"> + <a href="/fr/docs/Web/HTML/Catégorie_de_contenu" + >Catégories de contenu</a + > + </th> + <td>Aucune.</td> + </tr> + <tr> + <th scope="row">Contenu autorisé</th> + <td>Aucun, c'est un élément vide.</td> + </tr> + <tr> + <th scope="row">Omission de balises</th> + <td> + Cet élément doit avoir une balise ouvrante mais pas de balise fermante. + </td> + </tr> + <tr> + <th scope="row"><dfn>Parents autorisés</dfn></th> + <td> + <div> + Un élément média —{{HTMLElement("audio")}} ou + {{HTMLelement("video")}}— pour lequel l'élément + <code><source></code> doit être placé avant + <a href="/fr/docs/Web/HTML/Catégorie_de_contenu#Contenu_de_flux" + >tout contenu de flux</a + > + ou tout élément {{HTMLElement("track")}}. + </div> + <div> + Un élément {{HTMLElement("picture")}}, pour lequel l'élément + <code><source></code> doit être placé avant tout élément + {{HTMLElement("img")}}. + </div> + </td> + </tr> + <tr> + <th scope="row">Rôles ARIA autorisés</th> + <td>Aucun.</td> + </tr> + <tr> + <th scope="row">Interface DOM</th> + <td>{{domxref("HTMLSourceElement")}}</td> + </tr> + </tbody> </table> -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', 'embedded-content.html#the-source-element', '<source>')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - </tbody> -</table> +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ------------ | +| {{SpecName('HTML WHATWG', 'embedded-content.html#the-source-element', '<source>')}} | {{Spec2('HTML WHATWG')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("html.elements.source")}}</p> +{{Compat("html.elements.source")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{HTMLElement("picture")}}</li> - <li>{{HTMLElement("audio")}}</li> - <li>{{HTMLElement("video")}}</li> - <li><a href="/fr/docs/Learn/Performance">Les performances sur le Web</a></li> -</ul> +- {{HTMLElement("picture")}} +- {{HTMLElement("audio")}} +- {{HTMLElement("video")}} +- [Les performances sur le Web](/fr/docs/Learn/Performance) |