<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 vorhanden sein.

Die verwendete Basis-URL eines Dokuments kann durch Skripte mit Node.baseURI abgerufen werden. Wenn das Dokument keine <base> Elemente besitzt, wird 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 beides besitzen. Wenn mindestens eines dieser Attribute angegeben ist, muss das <base> Element vor anderen Elementen kommen, deren Attributwerte URLs sind, wie zum Beispiel 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-Kontextes, 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): 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, falls die aktuelle Seite in einem Frame enthalten ist. Wenn es keinen Eltern gibt, verhält es sich wie _self.
_top: Zeigt das Ergebnis im obersten Browsing-Kontext an (derjenige Browsing-Kontext, der ein Vorfahre des aktuellen ist und keinen Eltern hat). Wenn es keinen Eltern gibt, verhält es sich wie _self.

Verwendungshinweise

Mehrere `<base>` Elemente

Wenn mehrere <base> Elemente verwendet werden, werden nur die ersten href und target berücksichtigt — alle anderen werden ignoriert.

Anker im Dokument

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

Beispielsweise: Angenommen es gibt <base href="https://example.com/"> und diesen Link: <a href="#anchor">Zu Anker</a>. Der Link verweist auf https://example.com/#anchor.

target darf keine ASCII Newlines, Tabs oder < enthalten

Wenn das target Attribut eine ASCII-Newline, Tab oder < enthält, wird der Wert auf _blank zurückgesetzt. Dies soll Angriffe durch hängende Markup-Injektionen verhindern, eine skriptlose Attacke, bei der ein nicht geschlossenes target Attribut in die Seite injiziert wird, sodass jeder nachfolgende Text erfasst wird, bis der Browser ein Zeichen erreicht, das das Attribut schließt.

Open Graph

Open Graph Tags erkennen <base> nicht an und sollten immer vollständige absolute URLs beinhalten. Beispielsweise:

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.
Erlaubte Inhalte	Keine; es ist ein leeres Element.
Tag-Auslassung	Muss einen Starttag haben und darf keinen Endtag 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