<base>: Das Dokument-Basis-URL-Element

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Das <base> HTML-Element legt die Basis-URL fest, die für alle relativen URLs in einem Dokument verwendet wird. Es kann nur ein <base>-Element in einem Dokument geben.

Die verwendete Basis-URL eines Dokuments kann von Skripten mit Node.baseURI abgerufen werden. Wenn das Dokument keine <base>-Elemente enthält, ist baseURI standardmäßig auf location.href gesetzt.

Attribute

Die Attribute dieses Elements umfassen die globalen Attribute.

Warnung: Ein <base>-Element muss ein href-Attribut, ein target-Attribut oder beide besitzen. Wenn mindestens eines dieser Attribute angegeben ist, muss das <base>-Element vor anderen Elementen mit Attributwerten, die URLs enthalten, wie z. B. dem href-Attribut eines <link>, stehen.

href

Die Basis-URL, die im gesamten Dokument für relative URLs verwendet wird. Absolute und relative URLs sind erlaubt. data:- und javascript:-URLs sind nicht erlaubt.

target

Ein Schlüsselwort oder ein benutzerdefinierter Name des Standard-Browsing-Kontexts, in dem die Ergebnisse der Navigation von <a>, <area> oder <form>-Elementen ohne explizite target-Attribute angezeigt werden sollen. Die folgenden Schlüsselwörter haben spezielle Bedeutungen:

_self (Standard): Die Ergebnisse im aktuellen Browsing-Kontext anzeigen.
_blank: Die Ergebnisse in einem neuen, unbenannten Browsing-Kontext anzeigen.
_parent: Die Ergebnisse im übergeordneten Browsing-Kontext des aktuellen Kontexts anzeigen, wenn die aktuelle Seite sich innerhalb eines Frames befindet. Wenn es keinen übergeordneten Kontext gibt, verhält sich das wie _self.
_top: Die Ergebnisse im obersten Browsing-Kontext anzeigen (der Browsing-Kontext, der ein Vorfahr des aktuellen ist und keinen übergeordneten Kontext hat). Wenn es keinen übergeordneten Kontext gibt, verhält sich das wie _self.

Hinweise zur Nutzung

Mehrere <base>-Elemente

Wenn mehrere <base>-Elemente verwendet werden, werden nur das erste href und das erste target beachtet – alle anderen werden ignoriert.

Anker im Dokument

Links, die auf ein Fragment im Dokument zeigen – z. B. <a href="#some-id"> – werden mit dem <base> aufgelöst, was eine HTTP-Anfrage an die Basis-URL mit dem angehängten Fragment auslöst.

Zum Beispiel: Gegeben <base href="https://example.com/"> und diesen Link: <a href="#anchor">To anchor</a>. Der Link zeigt auf https://example.com/#anchor.

target darf keine ASCII-Zeilenumbrüche, Tabs oder < enthalten

Wenn das target-Attribut einen ASCII-Zeilenumbruch, einen Tab oder das <-Zeichen enthält, wird der Wert auf _blank zurückgesetzt. Dies dient dazu, danglende Markup-Injektionen zu verhindern, eine skriptlose Angriffsmethode, bei der ein ungeschlossenes target-Attribut in die Seite injiziert wird, sodass jeglicher Text danach erfasst wird, bis der Browser auf ein Zeichen stößt, das das Attribut schließt.

Open Graph

Open Graph-Tags erkennen <base> nicht und sollten immer vollständige absolute URLs enthalten. Zum Beispiel:

html

<meta property="og:image" content="https://example.com/thumbnail.jpg" />

Beispiele

html

<base href="https://www.example.com/" />
<base target="_blank" />
<base target="_top" href="https://example.com/" />

Technische Zusammenfassung

Inhaltskategorien	Metadaten-Inhalt.
Zulässiger Inhalt	Keiner; es ist ein void-Element.
Tag-Auslassung	Muss ein Start-Tag haben und darf keinen End-Tag haben.
Zulässige Eltern	Ein `<head>`, das kein weiteres `<base>`-Element enthält.
Implizierte ARIA-Rolle	Keine entsprechende Rolle
Zulässige ARIA-Rollen	Kein `role` erlaubt
DOM-Schnittstelle	[`HTMLBaseElement`](/de/docs/Web/API/HTMLBaseElement)

Spezifikationen

Specification
HTML # the-base-element

Browser-Kompatibilität

BCD tables only load in the browser