L'élément <base> 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 <base> au sein d'un document.
Il est possible d'accéder à l'URL de base d'un document via un script en utilisant document.baseURI.
| Catégories de contenu | Contenu de méta-données. |
|---|---|
| Contenu autorisé | Aucun, c'est un élément vide. |
| Omission de balises | Il ne doit pas y avoir de balise fermante. |
|
Parents autorisés |
N'importe quel élément <head> qui ne contient pas un autre élément <base>. |
| Rôles ARIA autorisés | Aucun. |
| Interface DOM | HTMLBaseElement |
Attributs
Les attributs universels peuvent être utilisés sur cet élément.
href- 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.
Les URI absolues et relatives sont autorisées (voir la note ci-après). target- 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 (target) explicitement déclarées. En HTML4 c'est un nom ou un mot-clé associé à une frame. En HTML5, c'est un nom ou un mot-clé associé à un contexte de navigation (par exemple un onglet, une fenêtre ou une frame). Les mots-clés qui sont utilisés ont la signification suivante :
_self: Charge le résultat dans la même frame 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é._blank: Charge le résultat dans une nouvelle fenêtre HTML4 non-nommée ou dans un nouveau contexte de navigation HTML5._parent: Charge le résultat dans le frameset parent de la frame 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_self._top: En HTML4, charge le résultat dans la fenêtre originelle, supprimant les autres frames. 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_self.
Notes d'utilisation
Si plusieurs éléments <base> sont utilisés, seules les premières valeurs pour href et target sont utilisées, les autres valeurs sont ignorées.
Exemples
Exemple 1
<base href="http://www.exemple.com/"> <base target="_blank" href="http://www.exemple.com/">
Exemple 2
Utiliser <base> puis une ancre (un élément <a>) plus bas dans le document entraînera la résolution de l'URL pointée par l'ancre en combinant la base puis l'ancre :
<base href="https://www.example.com/"> ... <a href="#ancre">Une ancre</a> <!-- pointera vers https://www.example.com/#ancre -->
OpenGraph
Les éléments <meta> OpenGraph ne résolvent pas l'URL par rapport à la base indiquée, il est donc nécessaire d'indiquer une URL complète :
<meta property='og:image' content='http://example.com/thumbnail.jpg'>
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| HTML Living Standard La définition de '<base>' dans cette spécification. |
Standard évolutif | Aucune modification depuis la dernière dérivation. |
| HTML5 La définition de '<base>' dans cette spécification. |
Recommendation | Définition du comportement de l'attribut target. |
| HTML 4.01 Specification La définition de '<base>' dans cette spécification. |
Recommendation | Ajout de l'attribut target. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | Oui | Oui | 1 | Oui1 | Oui | Oui |
href | Oui | Oui | 1 | Oui | Oui | Oui |
target | Oui | Oui | Oui | Oui | Oui | Oui |
| Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| Support simple | Oui | Oui | Oui | 4 | Oui | Oui | Oui |
href | Oui | Oui | Oui | 4 | Oui | Oui | Oui |
target | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
1. Before Internet Explorer 7, <base> can be positioned anywhere in the document and the nearest value of <base> is used.