<base>:文件基礎 URL 元素

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.

<base> HTML 元素指定用於文件中所有相對 URL 的基礎 URL。一個文件中只能有一個 <base> 元素。

腳本可以使用 Node.baseURI 存取文件的已使用基礎 URL。如果文件中沒有 <base> 元素,則 baseURI 默認為 location.href

屬性

此元素的屬性包括全域屬性

警告: <base> 元素必須具有 href 屬性、target 屬性或兩者都有。如果這些屬性中至少有一個被指定,則 <base> 元素必須出現在具有 URL 屬性值的其他元素之前,例如 <link>href 屬性。

href

用於整個文件中相對 URL 的基礎 URL。 允許絕對和相對 URL。 不允許 data:javascript: URL。

target

顯示來自 <a><area><form> 元素的導航結果的關鍵字作者定義的名稱的默認瀏覽上下文。以下關鍵字具有特殊含義:

  • _self(默認):在當前瀏覽上下文中顯示結果。
  • _blank:在新的、未命名的瀏覽上下文中顯示結果。
  • _parent:如果當前頁面位於框架中,則在當前瀏覽上下文的父瀏覽上下文中顯示結果。如果沒有父瀏覽上下文,則與 _self 相同。
  • _top:在最上層的瀏覽上下文中(當前瀏覽上下文的祖先且沒有父瀏覽上下文)顯示結果。如果沒有父瀏覽上下文,則與 _self 相同。

使用注意事項

多個 <base> 元素

如果使用多個 <base> 元素,只有第一個 href 和第一個 target 會被遵從,其它的將被忽略。

頁內錨點

指向文檔片段的鏈接,例如 <a href="#some-id">,將使用 <base> 解析,觸發帶有片段的基礎 URL 的 HTTP 請求。

例如,給定 <base href="https://example.com/"> 和此鏈接:<a href="#anchor">到錨點</a>。該鏈接指向 https://example.com/#anchor

開放社交關係圖

Open Graph 標籤不會認識 <base>,應始終使用完整的絕對 URL。例如:

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

範例

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

技術概要

內容類型 元數據內容。
允許的內容 無;它是一個置空元素
標籤省略 不得有結束標籤。
允許的父元素 一個不包含其他 <base> 元素的 <head>
隱含 ARIA 角色 無對應角色
允許的 ARIA 角色 不允許 role
DOM 介面 HTMLBaseElement

規範

Specification
HTML
# the-base-element

瀏覽器相容性

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