<base>: Das Document Base 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 gibt die Basis-URL an, die für alle relativen URLs in einem Dokument verwendet werden soll. Es darf nur ein <base>-Element in einem Dokument vorhanden sein.

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

Attribute

Die Attribute dieses Elements schließen die globalen Attribute ein.

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

href

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

target

Ein Schlüsselwort oder autordefinierter Name des Standard-Browser-Kontextes, um die Ergebnisse der Navigation von <a>, <area>, oder <form>-Elementen ohne explizite target-Attribute anzuzeigen. Die folgenden Schlüsselwörter haben spezielle Bedeutungen:

  • _self (Standard): Zeigt das Ergebnis im aktuellen Browser-Kontext an.
  • _blank: Zeigt das Ergebnis in einem neuen, unbenannten Browser-Kontext an.
  • _parent: Zeigt das Ergebnis im übergeordneten Browser-Kontext des aktuellen an, falls die aktuelle Seite in einem Rahmen liegt. Wenn es keinen übergeordneten Kontext gibt, verhält es sich wie _self.
  • _top: Zeigt das Ergebnis im obersten Browser-Kontext an (dem Browser-Kontext, der ein Vorfahre des aktuellen ist und keinen übergeordneten Kontext hat). Wenn es keinen übergeordneten Kontext gibt, verhält es sich wie _self.

Anwendungshinweise

Mehrere -Elemente

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

Anker innerhalb der Seite

Links, die auf ein Fragment im Dokument verweisen — z.B. <a href="#some-id"> — werden mit der <base> aufgelöst, wodurch eine HTTP-Anfrage an die Basis-URL mit dem angehängten Fragment ausgelöst wird.

Zum Beispiel, gegeben <base href="https://example.com/"> und diesen Link: <a href="#anchor">Zum Anker</a>. Der Link verweist auf https://example.com/#anchor.

target darf keine ASCII-Newline, Tab oder < enthalten

Wenn das target-Attribut eine ASCII-Newline, einen Tab oder das <-Zeichen enthält, wird der Wert auf _blank zurückgesetzt. Dies soll verhindern, dass Markup-Injektionsangriffe ohne Skripte erfolgen, bei denen ein nicht geschlossenes target-Attribut in die Seite injiziert wird, sodass jeder nachfolgende Text erfasst wird, bis der Browser auf ein Zeichen stößt, das das Attribut schließt.

Open Graph

Open Graph-Tags erkennen <base> nicht an und sollten immer vollständige absolute URLs haben. 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.
Erlaubter Inhalt Keiner; es ist ein leeres Element.
Tag-Auslassung Muss ein Start-Tag haben und darf kein End-Tag haben.
Erlaubte Eltern Ein <head>, das kein weiteres <base>-Element enthält.
Implizierte ARIA-Rolle Keine entsprechende Rolle
Erlaubte ARIA-Rollen Keine role erlaubt
DOM-Schnittstelle [`HTMLBaseElement`](/de/docs/Web/API/HTMLBaseElement)

Spezifikationen

Specification
HTML
# the-base-element

Browser-Kompatibilität