<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 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 kein <base> Element hat, ist der Standardwert von baseURI location.href.

Attribute

Zu den Attributen dieses Elements gehören die globalen Attribute.

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, kommen, wie z.B. das href Attribut eines <link>.

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 ein vom Autor definierter Name des Standard-Browsing-Kontexts, um die Ergebnisse der Navigation von <a>, <area>, oder <form> Elementen ohne explizite target Attribute anzuzeigen. Die folgenden Schlüsselwörter haben besondere Bedeutungen:

  • _self (Standard): Zeigt das Ergebnis im aktuellen Browsing-Kontext an.
  • _blank: Zeigt das Ergebnis in einem neuen, unbenannten Browsing-Kontext an.
  • _parent: Zeigt das Ergebnis im übergeordneten Browsing-Kontext des aktuellen an, wenn die aktuelle Seite in einem Frame ist. Wenn es keinen übergeordneten gibt, wirkt es wie _self.
  • _top: Zeigt das Ergebnis im obersten Browsing-Kontext an (dem Browsing-Kontext, der ein Vorfahre des aktuellen ist und keinen übergeordneten hat). Wenn es keinen übergeordneten gibt, wirkt es wie _self.

Hinweise zur Nutzung

Mehrere <base> Elemente

Wenn mehrere <base> Elemente verwendet werden, wird nur href und target des ersten Elements berücksichtigt — alle weiteren werden ignoriert.

Anker im Dokument

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

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-Zeilenumbrüche, Tabs oder < enthalten

Wenn das target Attribut einen ASCII-Zeilenumbruch, Tab oder das < Zeichen enthält, wird der Wert auf _blank zurückgesetzt. Dies soll verhindern, dass ungeschlossene target Attribute in die Seite injiziert werden, eine skriptlose Angriffstechnik, bei der ein ungeschlossenes target Attribut injiziert wird, sodass jeglicher nachfolgender Text erfasst wird, bis der Browser ein Zeichen erreicht, das das Attribut schließt.

Open Graph

Open Graph Tags erkennen <base> nicht 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 Metadateninhalt.
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.
Implizite ARIA-Rolle Keine entsprechende Rolle
Zulässige ARIA-Rollen Keine role erlaubt
DOM-Schnittstelle [`HTMLBaseElement`](/de/docs/Web/API/HTMLBaseElement)

Spezifikationen

Specification
HTML
# the-base-element

Browser-Kompatibilität