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.org.cn/">
    <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 表格仅在浏览器中加载

另请参阅