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

<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 Standard
# the-base-element

瀏覽器相容性

BCD tables only load in the browser