aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/html/element/base/index.html
blob: 9a88ff2286332ef5acf53f64f9eea2e513bfa03b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
---
title: '<base> : l''élément pour l''URL de base du document'
slug: Web/HTML/Element/base
tags:
  - Element
  - HTML
  - HTML document metadata
  - HTML:Metadata content
  - Reference
translation_of: Web/HTML/Element/base
browser-compat: html.elements.base
---
<div>{{HTMLRef}}</div>

<p>L'élément <strong><code>&lt;base&gt;</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>&lt;base&gt;</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 <a href="/fr/docs/Web/API/Node/baseURI"><code>Node.baseURI</code></a>. Si le document ne possède pas d'élément <code>&lt;base&gt;</code>; la base par défaut pour la composition des URL sera l'URL courante.</p>

<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>&lt;head&gt;</code></a> qui ne contient pas un autre élément <a href="/fr/docs/Web/HTML/Element/base"><code>&lt;base&gt;</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/Global_attributes">attributs universels</a> peuvent être utilisés sur cet élément.</p>

<div class="warning">
  <p><strong>Attention :</strong> 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>&lt;link&gt;</code></a>.</p>
</div>

<dl>
  <dt><strong><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><code>target</code></strong></dt>
  <dd><p>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>&lt;a&gt;</code></a>, <a href="/fr/docs/Web/HTML/Element/area"><code>&lt;area&gt;</code></a> ou <a href="/fr/docs/Web/HTML/Element/Form"><code>&lt;form&gt;</code></a> sans attributs <code>target</code> explicites.</p>
  <p>Les mots-clés suivants ont des significations particulières :</p>
    <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="usage_notes">Notes d'utilisation</h2>

<h3 id="multiple_&lt;base&gt;_elements">Éléments &lt;base&gt; multiples</h3>

<p>Si plusieurs éléments <code>&lt;base&gt;</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="in-page_anchors">Ancres dans la page</h3>

<p>Les ancres d'une page (<a href="/fr/docs/Web/HTML/Element/a"><code>&lt;a&gt;</code></a>), par exemple <code>&lt;a href="#ancre"&gt;ancre&lt;/a&gt;</code>, sont résolues avec l'URL de base fournie via <code>&lt;base&gt;</code> et déclenche une requête HTTP vers l'URL de base.</p>

<ol>
 <li>Soit <code>&lt;base href="https://example.com"&gt;</code></li>
 <li>… et ce lien : <code>&lt;a href="#ancre"&gt;Anker&lt;/a&gt;</code></li>
 <li>… le lien enverra vers <code>https://example.com/#ancre</code>.</li>
</ol>

<h3 id="open_graph">Open Graph</h3>

<p>Les balises <a href="https://ogp.me/">Open Graph</a> ne tiennent pas de compte de l'élément <code>&lt;base&gt;</code>, et doivent toujours avoir des URL absolues complètes. Par exemple :</p>

<pre class="brush: html">&lt;meta property="og:image" content="https://example.com/thumbnail.jpg"&gt;</pre>

<h2 id="examples">Exemples</h2>

<pre class="brush: html">&lt;base href="https://www.example.com/"&gt;
&lt;base target="_blank"&gt;
&lt;base target="_top" href="https://example.com/"&gt;
</pre>

<h2 id="specifications">Spécifications</h2>

<p>{{Specifications}}</p>

<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>

<p>{{Compat}}</p>