href

**href** 屬性將連結定義為對資源的引用 URL。該連結的確切含義取決於使用它的每個元素的上下文。

**注意:** SVG 2 之前的規範定義了xlink:href 屬性,該屬性現在已被href 屬性棄用。如果需要支援早期瀏覽器版本,可以將已棄用的xlink:href 屬性作為回退,除了href 屬性,例如<use href="some-id" xlink:href="some-id" x="5" y="5" />

您可以將此屬性與以下 SVG 元素一起使用

示例

html
<svg viewBox="0 0 160 40" xmlns="http://www.w3.org/2000/svg">
  <a href="https://mdn.club.tw/">
    <text x="10" y="25">MDN Web Docs</text>
  </a>
</svg>

在 SVG 中

a

對於 <a>href 定義了引用的物件的地址,用 URL 引用表示。

<url>
預設值
可動畫

animate,animateMotion,animateTransform,set

對於 <animate><animateMotion><animateTransform><set>href 定義了指向作為此動畫元素的目標元素的 URL,因此該元素將隨著時間推移而修改。

該 URL 必須指向一個能夠作為給定動畫元素目標的單個目標元素。如果 URL 指向多個目標元素,如果給定目標元素不能作為給定動畫元素的目標,或者如果給定目標元素不是當前文件的一部分,那麼動畫元素將不會影響任何目標元素。但是,動畫元素仍然會在其時間屬性方面正常執行。具體來說,會排程 TimeEvents,並且動畫元素可以用與 URL 引用有效目標元素時相同的方式用作 syncbase。

如果沒有提供href 屬性或已棄用的xlink:href 屬性,那麼目標元素將是當前動畫元素的直接父元素。如果同時指定了xlink:hrefhref,則使用後者屬性的值。

請參閱各個動畫元素的描述,瞭解對哪些型別的元素可以作為特定型別的動畫目標的任何限制。

除了本規範中明確提到的任何 SVG 特定規則之外,此屬性的規範定義是SMIL 動畫規範。特別是,請參閱SMIL 動畫:指定動畫目標

<url>
預設值
可動畫

feImage

對於 <feImage>href 定義了指向影像資源或元素的 URL。如果同時指定了xlink:hrefhref 屬性,則後者將覆蓋前者。

<url>
預設值
可動畫

image

對於 <image>href 定義了指向要渲染的影像的 URL。

<url>
預設值
可動畫
html
<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
  <image href="fxlogo.png" x="0" y="0" height="100" width="100" />
</svg>

linearGradient

對於 <linearGradient>href 定義了指向模板梯度元素的 URL;為了有效,引用必須指向不同的<linearGradient><radialGradient> 元素。

<url>
預設值
可動畫

mpath

對於 <mpath>href 定義了指向定義運動路徑的 <path> 元素或 基本形狀 的 URL。

<url>
預設值
可動畫

pattern

對於 <pattern>href 定義了指向當前 SVG 文件中不同<pattern> 元素的 URL。在引用的元素上定義的但在該元素上未定義的任何屬性都會由此元素繼承。如果該元素沒有子元素,而引用的元素有(可能是由於它自己的href 屬性),那麼該元素將從引用的元素繼承子元素。繼承可以間接地進行到任意級別;因此,如果引用的元素由於它自己的href 屬性而繼承了屬性或子元素,那麼當前元素可以繼承這些屬性或子元素。在 <pattern> 元素上,href 屬性是可動畫的。

<url>
預設值
可動畫

radialGradient

對於 <radialGradient>href 定義了指向模板梯度元素的 URL;為了有效,引用必須指向不同的 <linearGradient><radialGradient> 元素。

<url>
預設值
可動畫

script

對於 <script>href 定義了指向包含指令碼程式碼的外部資源的 URL。

<url>
預設值
可動畫

textPath

對於 <textPath>href 定義了指向 <path> 元素或 基本形狀 的 URL,如果未提供path 屬性,文字將渲染到該元素上。在 <textPath> 元素上,href 屬性是可動畫的。

<url>
預設值
可動畫

use

對於 <use>href 定義了一個 URL,它引用了要克隆的 SVG 文件中的元素或片段。

<use> 元素可以透過指定沒有片段的 href 值來引用整個 SVG 文件。此類引用被認為是指向所引用文件的根元素。

<url>
預設值
可動畫

規範

未找到規範

未找到 svg.global_attributes.href 的規範資料。
檢查此頁面是否存在問題 或為缺少的 spec_url 貢獻程式碼。 mdn/browser-compat-data。 還要確保規範包含在 w3c/browser-specs.

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱