SVGUseElement: href property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

We'd love to hear more about your role and the company you work for
Please help us by answering a few questions.

The href read-only property of the SVGUseElement interface reflects the href or xlink:href attribute of the given element.

Value

An SVGAnimatedString object.

Examples

Given the following SVG:

html
<svg viewBox="0 0 200 200" xmlns="http://www.w3.org/2000/svg">
  <defs>
    <circle id="circle1" cx="50" cy="50" r="40" fill="blue" />
    <circle id="circle2" cx="50" cy="50" r="40" fill="red" />
  </defs>
  <use href="#circle1" x="50" y="50" />
  <use href="#circle2" x="100" y="50" />
</svg>

We can access the href attribute of the <use> elements:

js
const uses = document.querySelectorAll("use");
console.log(uses[0].href.baseVal); // output: "#circle1"
console.log(uses[1].href.baseVal); // output: "#circle2"

Specifications

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGURIReference__href

Browser compatibility