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,
body,
svg {
  height: 100%;
}

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>`
預設值	無
可動畫	是

animate、animateMotion、animateTransform、set

對於<animate>、<animateMotion>、<animateTransform> 和 <set>，xlink:href 定義對作為此動畫目標的元素的引用，因此該元素將隨時間推移而被修改。

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

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

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

請參閱各個動畫元素的描述，瞭解特定型別動畫的目標元素型別的任何限制。

值	`<iri>`
預設值	無
可動畫	否

cursor

對於<cursor>，xlink:href 定義對提供游標影像的檔案或元素的引用。

值	`<funciri>`
預設值	無
可動畫	是

feImage

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

值	`<iri>`
預設值	無
可動畫	是

對於<filter>，xlink:href 定義對當前 SVG 文件片段中另一個 <filter> 元素的引用。在此元素上未定義但在引用的 <filter> 元素上定義的任何屬性都將由此元素繼承。如果此元素沒有定義的過濾器節點，並且引用的元素有定義的過濾器節點（可能是由於其自己的 xlink:href 屬性），則此元素繼承從引用的 <filter> 元素定義的過濾器節點。繼承可以間接地達到任意級別；因此，如果引用的 <filter> 元素由於其自己的 xlink:href 屬性而繼承屬性或其過濾器節點規範，則當前元素可以繼承這些屬性或過濾器節點規範。

值	`<iri>`
預設值	無
可動畫	是

font-face-uri

對於<font-face-uri>，xlink:href 定義引用的字型的地址。

值	`<iri>`
預設值	無
可動畫	否

glyphRef

對於<glyphRef>，xlink:href 定義到 SVG 文件片段中的<glyph> 元素。引用的 <glyph> 將呈現為備用字形。

值	`<iri>`
預設值	無
可動畫	否

image

對於<image>，xlink:href 定義引用的影像的地址。

值	`<iri>`
預設值	無
可動畫	是

linearGradient

對於<linearGradient>，xlink:href 定義對當前 SVG 文件片段中不同的 <linearGradient> 或<radialGradient> 元素的引用。在此元素上未定義但在引用的元素上定義的任何 <linearGradient> 屬性都將由此元素繼承。如果此元素沒有定義的漸變停止，並且引用的元素有（可能是由於其自己的 xlink:href 屬性），則此元素繼承來自引用的元素的漸變停止。繼承可以間接地達到任意級別；因此，如果引用的元素由於其自己的 xlink:href 屬性而繼承屬性或漸變停止，則當前元素可以繼承這些屬性或漸變停止。

值	`<iri>`
預設值	無
可動畫	是

mpath

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

值	`<iri>`
預設值	無
可動畫	否

pattern

對於 <pattern>，xlink:href 定義了對當前 SVG 文件片段中另一個 <pattern> 元素的引用。此元素未定義但在被引用元素上定義的任何屬性都將由此元素繼承。如果此元素沒有子元素，而被引用元素有子元素（可能是由於其自身的 xlink:href 屬性），則此元素將繼承被引用元素的子元素。繼承可以間接進行到任意級別；因此，如果被引用元素由於其自身的 xlink:href 屬性而繼承了屬性或子元素，則當前元素可以繼承這些屬性或子元素。

值	`<iri>`
預設值	無
可動畫	是

radialGradient

對於 <radialGradient>，xlink:href 定義了對當前 SVG 文件片段中另一個 <linearGradient> 或 <radialGradient> 元素的引用。此元素未定義但在被引用元素上定義的任何 <radialGradient> 屬性都將由此元素繼承。如果此元素沒有定義漸變停止點，而被引用元素有漸變停止點（可能是由於其自身的 xlink:href 屬性），則此元素將繼承被引用元素的漸變停止點。繼承可以間接進行到任意級別；因此，如果被引用元素由於其自身的 xlink:href 屬性而繼承了屬性或漸變停止點，則當前元素可以繼承這些屬性或漸變停止點。

值	`<iri>`
預設值	無
可動畫	是

script

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

值	`<iri>`
預設值	無
可動畫	否

textPath

對於 <textPath>，xlink:href 定義了對將要呈現字形的 <path> 元素的引用。

值	`<iri>`
預設值	無
可動畫	是

use

對於 <use>，xlink:href 定義了被引用物件的地址。

值	`<iri>`
預設值	無
可動畫	是

tref

對於 <tref>，xlink:href 定義了對一個元素的引用，該元素的字元資料內容將用作此 <tref> 元素的字元資料。

值	`<iri>`
預設值	無
可動畫	是

規範

規範
可縮放向量圖形 (SVG) 2 # XLinkHrefAttribute

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱

href