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

浏览器兼容性

另见