diff options
Diffstat (limited to 'files/fr/web/html/element/base/index.html')
| -rw-r--r-- | files/fr/web/html/element/base/index.html | 170 |
1 files changed, 80 insertions, 90 deletions
diff --git a/files/fr/web/html/element/base/index.html b/files/fr/web/html/element/base/index.html index c98d297dd2..151e595f3e 100644 --- a/files/fr/web/html/element/base/index.html +++ b/files/fr/web/html/element/base/index.html @@ -4,119 +4,109 @@ slug: Web/HTML/Element/base tags: - Element - HTML + - HTML document metadata + - HTML:Metadata content - Reference - - Web translation_of: Web/HTML/Element/base +browser-compat: html.elements.base --- <div>{{HTMLRef}}</div> -<p>L'élément <strong><code><base></code></strong> définit l'URL de base à utiliser pour recomposer toutes les URL relatives contenues dans un document. Il ne peut y avoir qu'un seul élément <code><base></code> au sein d'un document.</p> +<p class="summary">L'élément <strong><code><base></code></strong> définit l'URL de base à utiliser pour recomposer toutes les URL relatives contenues dans un document. Il ne peut y avoir qu'un seul élément <code><base></code> au sein d'un document.</p> -<p>Il est possible d'accéder à l'URL de base d'un document via un script en utilisant {{domxref('document.baseURI')}}.</p> +<p>Il est possible d'accéder à l'URL de base d'un document via un script en utilisant <a href="/fr/docs/Web/API/Node/baseURI"><code>Node.baseURI</code></a>. Si le document ne possède pas d'élément <code><base></code>; la base par défaut pour la composition des URL sera l'URL courante.</p> -<h2 id="Attributs">Attributs</h2> +<table class="properties"> + <tbody> + <tr> + <th scope="row"><a href="/fr/docs/Web/Guide/HTML/Content_categories">Catégories de contenu</a></th> + <td>Contenu de méta-données.</td> + </tr> + <tr> + <th scope="row">Contenu autorisé</th> + <td>Aucun, c'est un <a href="/fr/docs/Glossary/Empty_element">élément vide</a>.</td> + </tr> + <tr> + <th scope="row">Omission de balises</th> + <td>Il ne doit pas y avoir de balise fermante.</td> + </tr> + <tr> + <th scope="row">Parents autorisés</th> + <td>N'importe quel élément <a href="/fr/docs/Web/HTML/Element/head"><code><head></code></a> qui ne contient pas un autre élément <a href="/fr/docs/Web/HTML/Element/base"><code><base></code></a>.</td> + </tr> + <tr> + <th scope="row">Rôle ARIA implicite</th> + <td><a href="https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role">Pas de rôle correspondant</a></td> + </tr> + <tr> + <th scope="row">Rôles ARIA autorisés</th> + <td>Aucun.</td> + </tr> + <tr> + <th scope="row">Interface DOM</th> + <td><a href="/fr/docs/Web/API/HTMLBaseElement"><code>HTMLBaseElement</code></a></td> + </tr> + </tbody> +</table> + +<h2 id="attributes">Attributs</h2> -<p>Les <a href="/fr/docs/Web/HTML/Attributs_universels">attributs universels</a> peuvent être utilisés sur cet élément.</p> +<p>Les <a href="/fr/docs/Web/HTML/Global_attributes">attributs universels</a> peuvent être utilisés sur cet élément.</p> + +<div class="notecard warning"> + <p><b>Attention</b></p> + <p>Si l'un des attributs suivants est spécifié, cet élément <strong>doit</strong> venir avant d'autres éléments dont les valeurs d'attribut sont des URL, comme l'attribut <code>href</code> de <a href="/fr/docs/Web/HTML/Element/link"><code><link></code></a>.</p> +</div> <dl> - <dt>{{htmlattrdef("href")}}</dt> - <dd>L'URL de base à utiliser afin de recomposer les URL relatives contenues dans le document. Si cet attribut est défini, cet élément doit être présent avant les éléments dont les attributs sont des URL.<br> - Les URI absolues et relatives sont autorisées (voir la note ci-après).</dd> - <dt>{{htmlattrdef("target")}}</dt> - <dd>Un nom ou un mot-clé qui indique l'emplacement par défaut à utiliser pour afficher le résultat de la navigation via les hyperliens ou les formulaires. Il sera utilisé pour les éléments qui ne possèdent pas de cible (<em>target</em>) explicitement déclarées. En HTML4 c'est un nom ou un mot-clé associé à une <em>frame</em>. En HTML5, c'est un nom ou un mot-clé associé à un <em>contexte de navigation</em> (par exemple un onglet, une fenêtre ou une <em>frame</em>). Les mots-clés qui sont utilisés ont la signification suivante : - <ul> - <li><code>_self</code> : Charge le résultat dans la même <em>frame</em> HTML4 ou dans le même contexte de navigation HTML5 que le contexte courant. C'est la valeur par défaut de l'attribut s'il n'est pas utilisé.</li> - <li><code>_blank</code> : Charge le résultat dans une nouvelle fenêtre HTML4 non-nommée ou dans un nouveau contexte de navigation HTML5.</li> - <li><code>_parent</code> : Charge le résultat dans le <em>frameset</em> parent de la <em>frame</em> courante HTML4 ou dans le contexte de navigation parent du contexte courant HTML5. S'il n'y a pas de parent, cette option aura le même effet que <code>_self</code>.</li> - <li><code>_top</code> : En HTML4, charge le résultat dans la fenêtre originelle, supprimant les autres <em>frames</em>. En HTML5, charge le résultat dans le contexte de navigation de plus haut niveau (c'est-à-dire le contexte de navigation qui est un ancêtre du contexte courant et qui n'a pas de parent). S'il n'y a pas de parent, cette option aura le même effet que <code>_self</code>.</li> - </ul> - - <p>Si cet attribut est défini, cet élément devra être situé avant n'importe quel élément dont les valeurs des attributs sont des URL.</p> - </dd> + <dt><strong id="attr-href"><code>href</code></strong></dt> + <dd>L'URL de base à utiliser afin de recomposer les URL relatives contenues dans le document. Si cet attribut est défini, cet élément doit être présent avant les éléments dont les attributs sont des URL.<br> + Les URI absolues et relatives sont autorisées (voir la note ci-après).</dd> + <dt><strong id="attr-target"><code>target</code></strong></dt> + <dd>Un <strong>mot-clé</strong> ou un <strong>nom défini par l'auteur</strong> du <a href="/fr/docs/Glossary/Browsing_context">contexte de navigation</a> par défaut pour afficher les résultats de la navigation à partir des éléments <a href="/fr/docs/Web/HTML/Element/a"><code><a></code></a>, <a href="/fr/docs/Web/HTML/Element/area"><code><area></code></a> ou <a href="/fr/docs/Web/HTML/Element/Form"><code><form></code></a> sans attributs <code>target</code> explicites.</dd> + <dd>Les mots-clés suivants ont des significations particulières : + <ul> + <li><code>_self</code> : Charge le résultat dans le contexte de navigation courant. C'est la valeur par défaut de l'attribut s'il n'est pas utilisé.</li> + <li><code>_blank</code> : Charge le résultat dans un nouveau contexte de navigation.</li> + <li><code>_parent</code> : Charge le résultat dans le contexte de navigation parent du contexte courant. S'il n'y a pas de parent, cette option aura le même effet que <code>_self</code>.</li> + <li><code>_top</code> : Charge le résultat dans le contexte de navigation de plus haut niveau (c'est-à-dire le contexte de navigation qui est un ancêtre du contexte courant et qui n'a pas de parent). S'il n'y a pas de parent, cette option aura le même effet que <code>_self</code>.</li> + </ul> + </dd> </dl> -<h2 id="Notes_d'utilisation">Notes d'utilisation</h2> +<h2 id="usage_notes">Notes d'utilisation</h2> -<h3 id="Priorité">Priorité</h3> +<h3 id="multiple_<base>_elements">Éléments <base> multiples</h3> <p>Si plusieurs éléments <code><base></code> sont utilisés, seules les premières valeurs pour <code><strong>href</strong></code> et <code><strong>target</strong></code> sont utilisées, les autres valeurs sont ignorées.</p> -<h3 id="Ancres">Ancres</h3> +<h3 id="in-page_anchors">Ancres dans la page</h3> -<p>Les ancres d'une page ({{HTMLElement("a")}}), par exemple <code><a href="#ancre">ancre</a></code>, sont résolues avec l'URL de base fournie via <code><base></code> et déclenche une requête HTTP vers l'URL de base.</p> +<p>Les ancres d'une page (<a href="/fr/docs/Web/HTML/Element/a"><code><a></code></a>), par exemple <code><a href="#ancre">ancre</a></code>, sont résolues avec l'URL de base fournie via <code><base></code> et déclenche une requête HTTP vers l'URL de base.</p> -<p>Ainsi, avec un document qui contient <code><base href="http://www.example.com/"></code> et plus loin <code><a href="#ancre">Ancre</a></code>, le lien fourni par l'ancre pointera vers <code>http://www.example.com/#ancre</code>.</p> +<ol> + <li>Soit <code><base href="https://example.com"></code></li> + <li>… et ce lien : <code><a href="#ancre">Anker</a></code></li> + <li>… le lien enverra vers <code>https://example.com/#ancre</code>.</li> +</ol> -<h2 id="Exemples">Exemples</h2> +<h3 id="open_graph">Open Graph</h3> -<pre class="brush: html"><base href="http://www.example.com/"> -<base target="_blank" href="http://www.example.com/"> -</pre> +<p>Les balises <a href="https://ogp.me/">Open Graph</a> ne tiennent pas de compte de l'élément <code><base></code>, et doivent toujours avoir des URL absolues complètes. Par exemple :</p> -<h2 id="Résumé_technique">Résumé technique</h2> +<pre class="brush: html"><meta property="og:image" content="https://example.com/thumbnail.jpg"></pre> -<table class="properties"> - <tbody> - <tr> - <th><dfn><a href="/fr/docs/Web/HTML/Catégorie_de_contenu">Catégories de contenu</a></dfn></th> - <td><a href="/fr/docs/Web/HTML/Catégorie_de_contenu#Contenu_de_m.C3.A9ta-donn.C3.A9es">Contenu de méta-données</a>.</td> - </tr> - <tr> - <th><dfn>Contenu autorisé</dfn></th> - <td>Aucun, c'est un élément vide.</td> - </tr> - <tr> - <th><dfn>Omission de balises</dfn></th> - <td>Il ne doit pas y avoir de balise fermante.</td> - </tr> - <tr> - <th> - <p><dfn>Parents autorisés</dfn></p> - </th> - <td>N'importe quel élément {{HTMLElement("head")}} qui ne contient pas un autre élément {{HTMLElement("base")}}.</td> - </tr> - <tr> - <th>Rôles ARIA autorisés</th> - <td>Aucun.</td> - </tr> - <tr> - <th><dfn>Interface DOM</dfn></th> - <td>{{domxref("HTMLBaseElement")}}</td> - </tr> - </tbody> -</table> +<h2 id="examples">Exemples</h2> -<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', 'semantics.html#the-base-element', '<base>')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Aucune modification depuis la dernière dérivation.</td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', 'document-metadata#the-base-element', '<base>')}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Définition du comportement de l'attribut <code>target</code>.</td> - </tr> - <tr> - <td>{{SpecName('HTML4.01', 'struct/links.html#h-12.4', '<base>')}}</td> - <td>{{Spec2('HTML4.01')}}</td> - <td>Ajout de l'attribut <code>target</code>.</td> - </tr> - </tbody> -</table> +<pre class="brush: html"><base href="https://www.example.com/"> +<base target="_blank"> +<base target="_top" href="https://example.com/"> +</pre> + +<h2 id="specifications">Spécifications</h2> -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +<p>{{Specifications}}</p> -<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> +<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> -<p>{{Compat("html.elements.base")}}</p> +<p>{{Compat}}</p> |
