xlink:href

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

xlink:href 屬性定義了對資源的引用,作為 IRI 引用。該連結的確切含義取決於使用它的每個元素的上下文。

注意: SVG 2 移除了對 xlink 名稱空間的需求,因此你現在應該使用 href 而不是 xlink: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 xlink:href="https://mdn.club.tw/">
    <text x="10" y="25">MDN Web Docs</text>
  </a>
</svg>

a

對於 <a>xlink:href 定義了引用物件的位置。

<iri>
預設值 None
可動畫的

animate, animateMotion, animateTransform, set

對於 <animate><animateMotion><animateTransform><set>xlink:href 定義了對作為此動畫目標的元素的引用,該元素將隨時間修改。

目標元素必須是當前 SVG 文件片段的一部分。

該值必須指向恰好一個能夠成為給定動畫目標的目標元素。

如果未提供 xlink:href 屬性,則目標元素將是當前動畫元素的直接父元素。

有關何種型別的元素可以作為特定型別動畫的目標的任何限制,請參閱各個動畫元素的說明。

<iri>
預設值 None
可動畫的

feImage

對於 <feImage>xlink:href 定義了對影像源的引用。

<iri>
預設值 None
可動畫的

filter

對於 <filter>xlink:href 定義了對當前 SVG 文件片段中另一個 <filter> 元素的引用。任何在引用 <filter> 元素上定義但未在此元素上定義的屬性都會被此元素繼承。如果此元素沒有定義的濾鏡節點,並且引用元素有定義的濾鏡節點(可能由於其自身的 xlink:href 屬性),則此元素繼承引用 <filter> 元素定義的濾鏡節點。繼承可以是任意級別的間接繼承;因此,如果引用 <filter> 元素由於其自身的 xlink:href 屬性而繼承了屬性或其濾鏡節點規範,則當前元素可以繼承這些屬性或濾鏡節點規範。

<iri>
預設值 None
可動畫的

圖片

對於 <image>xlink:href 定義了引用影像的位置。

<iri>
預設值 None
可動畫的

linearGradient

對於 <linearGradient>xlink:href 定義了對當前 SVG 文件片段中不同 <linearGradient><radialGradient> 元素的引用。任何在引用元素上定義但未在此元素上定義的 <linearGradient> 屬性都會被此元素繼承。如果此元素沒有定義的漸變停止點,並且引用元素有(可能由於其自身的 xlink:href 屬性),則此元素繼承引用元素的漸變停止點。繼承可以是任意級別的間接繼承;因此,如果引用元素由於其自身的 xlink:href 屬性而繼承了屬性或漸變停止點,則當前元素可以繼承這些屬性或漸變停止點。

<iri>
預設值 None
可動畫的

mpath

對於 <mpath>xlink:href 定義了對定義運動路徑的 <path> 元素的引用。

<iri>
預設值 None
可動畫的

pattern

對於 <pattern>xlink:href 定義了對當前 SVG 文件片段中不同 <pattern> 元素的引用。任何在引用元素上定義但未在此元素上定義的屬性都會被此元素繼承。如果此元素沒有子元素,並且引用元素有(可能由於其自身的 xlink:href 屬性),則此元素繼承引用元素的子元素。繼承可以是任意級別的間接繼承;因此,如果引用元素由於其自身的 xlink:href 屬性而繼承了屬性或子元素,則當前元素可以繼承這些屬性或子元素。

<iri>
預設值 None
可動畫的

radialGradient

對於 <radialGradient>xlink:href 定義了對當前 SVG 文件片段中不同 <linearGradient><radialGradient> 元素的引用。任何在引用元素上定義但未在此元素上定義的 <radialGradient> 屬性都會被此元素繼承。如果此元素沒有定義的漸變停止點,並且引用元素有(可能由於其自身的 xlink:href 屬性),則此元素繼承引用元素的漸變停止點。繼承可以是任意級別的間接繼承;因此,如果引用元素由於其自身的 xlink:href 屬性而繼承了屬性或漸變停止點,則當前元素可以繼承這些屬性或漸變停止點。

<iri>
預設值 None
可動畫的

script

對於 <script>xlink:href 定義了對包含指令碼程式碼的外部資源的引用。

<iri>
預設值 None
可動畫的

textPath

對於 <textPath>xlink:href 定義了對將渲染字形的 <path> 元素的引用。

<iri>
預設值 None
可動畫的

use

對於 <use>xlink:href 定義了引用物件的位置。

<iri>
預設值 None
可動畫的

規範

規範
Scalable Vector Graphics (SVG) 2
# XLinkHrefAttribute

瀏覽器相容性

另見