xlink:href

Атрибут xlink:href задаёт ссылку на ресурс в виде ссылки IRI. Точное значение этой ссылки зависит от контекста каждого элемента, в котором она используется.

Этот атрибут можно использовать со следующими элементами SVG:

• <a>
• <animate>
• <animateMotion>
• <animateTransform>
• <feImage>
• <filter>
• <image>
• <linearGradient>
• <mpath>
• <pattern>
• <radialGradient>
• <script>
• <set>
• <textPath>
• <use>

Пример

<svg viewBox="0 0 160 40" xmlns="http://www.w3.org/2000/svg">
  <a xlink:href="https://developer.mozilla.org/">
    <text x="10" y="25">MDN Web Docs</text>
  </a>
</svg>

a

Для <a> атрибут xlink:href задаёт расположение объекта, на который указывает ссылка.

animate, animateMotion, animateTransform, set

Для <animate>, <animateMotion>, <animateTransform> и <set> атрибут xlink:href задаёт ссылку на элемент, являющийся целью этой анимации и, следовательно, изменяемый с течением времени.

Целевой элемент должен входить в текущий фрагмент документа SVG.

Значение должно указывать ровно на один элемент, который может быть целью данной анимации.

Если атрибут xlink:href не задан, целевым элементом будет непосредственный родительский элемент текущего элемента анимации.

Ограничения на типы элементов, которые могут быть целями определённых видов анимации, см. в описаниях отдельных элементов анимации.

feImage

Для <feImage> атрибут xlink:href задаёт ссылку на источник изображения.

filter

Для <filter> атрибут xlink:href задаёт ссылку на другой элемент <filter> в текущем фрагменте документа SVG. Все атрибуты, заданные для элемента <filter>, на который указывает ссылка, но не заданные для данного элемента, наследуются этим элементом. Если для данного элемента не заданы узлы фильтра, а для элемента, на который указывает ссылка, они заданы (возможно, благодаря его собственному атрибуту xlink:href), то данный элемент наследует узлы фильтра, заданные для указанного элемента <filter>. Наследование может быть косвенным и иметь произвольную глубину; поэтому, если указанный элемент <filter> наследует атрибуты или спецификацию узлов фильтра благодаря собственному атрибуту xlink:href, текущий элемент может наследовать эти атрибуты или спецификации узлов фильтра.

image

Для <image> атрибут xlink:href задаёт расположение изображения, на которое указывает ссылка.

linearGradient

Для <linearGradient> атрибут xlink:href задаёт ссылку на другой элемент <linearGradient> или <radialGradient> в текущем фрагменте документа SVG. Все атрибуты <linearGradient>, заданные для указанного элемента, но не заданные для данного элемента, наследуются им. Если для данного элемента не заданы цветовые переходы, а для указанного элемента они заданы (возможно, благодаря его собственному атрибуту xlink:href), данный элемент наследует цветовые переходы указанного элемента. Наследование может быть косвенным и иметь произвольную глубину; поэтому, если указанный элемент наследует атрибуты или цветовые переходы благодаря собственному атрибуту xlink:href, текущий элемент может наследовать эти атрибуты или цветовые переходы.

mpath

Для <mpath> атрибут xlink:href задаёт ссылку на элемент <path>, который определяет траекторию движения.

pattern

Для <pattern> атрибут xlink:href задаёт ссылку на другой элемент <pattern> в текущем фрагменте документа SVG. Все атрибуты, заданные для указанного элемента, но не заданные для данного элемента, наследуются им. Если у данного элемента нет дочерних элементов, а у указанного элемента они есть (возможно, благодаря его собственному атрибуту xlink:href), данный элемент наследует дочерние элементы указанного элемента. Наследование может быть косвенным и иметь произвольную глубину; поэтому, если указанный элемент наследует атрибуты или дочерние элементы благодаря собственному атрибуту xlink:href, текущий элемент может наследовать эти атрибуты или дочерние элементы.

radialGradient

Для <radialGradient> атрибут xlink:href задаёт ссылку на другой элемент <linearGradient> или <radialGradient> в текущем фрагменте документа SVG. Все атрибуты <radialGradient>, заданные для указанного элемента, но не заданные для данного элемента, наследуются им. Если для данного элемента не заданы цветовые переходы, а для указанного элемента они заданы (возможно, благодаря его собственному атрибуту xlink:href), данный элемент наследует цветовые переходы указанного элемента. Наследование может быть косвенным и иметь произвольную глубину; поэтому, если указанный элемент наследует атрибуты или цветовые переходы благодаря собственному атрибуту xlink:href, текущий элемент может наследовать эти атрибуты или цветовые переходы.

script

Для <script> атрибут xlink:href задаёт ссылку на внешний ресурс, содержащий код скрипта.

textPath

Для <textPath> атрибут xlink:href задаёт ссылку на элемент <path>, по которому будут располагаться глифы.

use

Для <use> атрибут xlink:href задаёт расположение объекта, на который указывает ссылка.

Спецификации

Совместимость с браузерами

См. также

• href