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.org.cn/">
    <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