xlink:href

Устаревшее: Эта функция больше не рекомендуется. Хотя некоторые браузеры могут её поддерживать, она может быть удалена из соответствующих веб-стандартов, может быть в процессе удаления или сохранена только для совместимости. Избегайте её использования и обновляйте существующий код, если это возможно; обратитесь к таблице совместимости внизу этой страницы, чтобы принять решение. Имейте в виду, что эта функция может перестать работать в любое время.

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

Примечание: SVG 2 убрал необходимость в пространстве имён xlink, поэтому вместо 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 xlink:href="https://developer.mozilla.org/">
    <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

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

Значение	`<iri>`
Значение по умолчанию	Нет
Анимируемо	Да

font-face-uri

Для <font-face-uri>, xlink:href определяет местоположение связанного шрифта.

Значение	`<iri>`
Значение по умолчанию	Нет
Анимируемо	Нет

glyphRef

Для <glyphRef>, xlink:href определяет ссылку на элемент <glyph> в фрагменте документа SVG. Связанный <glyph> отображается как альтернативный глиф.

Значение	`<iri>`
Значение по умолчанию	Нет
Анимируемо	Нет

image

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

Значение	`<iri>`
Значение по умолчанию	Нет
Анимируемо	Да

linearGradient

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

Значение	`<iri>`
Значение по умолчанию	Нет
Анимируемо	Да

mpath

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

Значение	`<iri>`
Значение по умолчанию	Нет
Анимируемо	Нет

pattern

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

Значение	`<iri>`
Значение по умолчанию	Ничего
Анимируемо	Да

radialGradient

Для <radialGradient>, xlink:href определяет ссылку на другой <linearGradient> или <radialGradient> элемент внутри текущего фрагмента документа SVG. Любые <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>`
Значение по умолчанию	Ничего
Анимируемо	Да

Технические характеристики

Спецификация
Scalable Vector Graphics (SVG) 2 # XLinkHrefAttribute

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

	Рабочие столы					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`xlink:href`	1	12	1.5	9	3.1	18	4	14	2	1.0	3

См. также

href

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/xlink:href