<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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
base
href
data: and javascript: urls are not allowed
Relative URIs.
target

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support