href
Атрибут href определяет ссылку на ресурс в виде ссылки URL. Точное значение этой ссылки зависит от контекста каждого элемента, использующего её.
Примечание: Спецификации до SVG 2 определяли атрибут xlink:href, который теперь устарел благодаря атрибуту href. Если вам нужно поддерживать более ранние версии браузеров, устаревший атрибут xlink:href может использоваться в качестве резервного варианта в дополнение к атрибуту href, например, <use href="some-id" xlink:href="some-id" x="5" y="5" />.
Вы можете использовать этот атрибут со следующими элементами SVG:
Пример
<svg viewBox="0 0 160 40" xmlns="http://www.w3.org/2000/svg"> <a href="https://developer.mozilla.org/"> <text x="10" y="25">MDN Web Docs</text> </a> </svg>
В SVG
a
animate, animateMotion, animateTransform, set
Для <animate>, <animateMotion>, <animateTransform> и <set>, href определяет URL, ссылающийся на элемент, который является целью данного элемента анимации и который, следовательно, будет изменяться со временем.
URL должен указывать ровно на один целевой элемент, который может быть целью данного элемента анимации. Если URL указывает на несколько целевых элементов, если данный целевой элемент не может быть целью данного элемента анимации или если данный целевой элемент не является частью текущего документа, то элемент анимации не повлияет на какой-либо целевой элемент. Однако элемент анимации по-прежнему будет работать нормально в отношении своих свойств тайминга. В частности, события TimeEvents отправляются, и элемент анимации может использоваться в качестве синхронизации аналогичным образом, как и когда URL ссылается на допустимый целевой элемент.
Если атрибут href или устаревший атрибут xlink:href не указаны, то целевой элемент будет являться непосредственным родительским элементом текущего элемента анимации. Если оба атрибута xlink:href и href указаны, используется значение последнего атрибута.
Обратитесь к описаниям отдельных элементов анимации для получения любых ограничений на типы элементов, которые могут быть целями определённых типов анимаций.
За исключением любых правил, специфичных для SVG, явно упомянутых в этой спецификации, нормативное определение этого атрибута — спецификация анимации SMIL. В частности, см. SMIL Animation: Указание целевого элемента анимации.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Нет |
feImage
Для <feImage>, href определяет URL, ссылающийся на ресурс изображения или на элемент. Если указаны оба атрибута xlink:href и href, второй переопределяет первый.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Да |
image
linearGradient
Для <linearGradient>, href определяет URL, ссылающийся на шаблонный элемент градиента; для корректности ссылка должна указывать на другой элемент <linearGradient> или <radialGradient>.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Да |
mpath
Для <mpath>, href определяет URL, ссылающийся на элемент <path> или базовую фигуру, которая определяет траекторию движения.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Нет |
pattern
Для <pattern>, href определяет URL, ссылающийся на другой элемент <pattern> в текущем документе SVG. Любые атрибуты, определённые в ссылаемом элементе, но не определённые в этом элементе, наследуются этим элементом. Если у этого элемента нет дочерних элементов, а у ссылаемого элемента есть (возможно, из-за его собственного атрибута href), то этот элемент наследует дочерние элементы от ссылаемого элемента. Наследование может быть косвенным до произвольного уровня; таким образом, если ссылаемый элемент наследует атрибуты или дочерние элементы из-за его собственного атрибута href, то текущий элемент может унаследовать эти атрибуты или дочерние элементы. В элементе <pattern> атрибут href анимируем.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Да |
radialGradient
Для <radialGradient>, href определяет URL, ссылающийся на шаблонный элемент градиента; для корректности ссылка должна указывать на другой элемент <linearGradient> или <radialGradient>.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Да |
script
textPath
Для <textPath>, href определяет URL, указывающий на элемент <path> или основную фигуру, на которую будет отрисовываться текст, если атрибут path не указан. В элементе <textPath> атрибут href анимируется.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Да |
use
Для <use>, href определяет URL, указывающий на элемент или фрагмент в документе SVG, который будет клонирован.
Элемент <use> может ссылаться на весь документ SVG, указав значение href без фрагмента. Такие ссылки относятся к корневому элементу указанного документа.
| Значение | <url> |
|---|---|
| Значение по умолчанию | Нет |
| Анимируемо | Да |
Технические характеристики
Данные спецификации не найдены для svg.global_attributes.href.
Проверьте наличие проблем на этой странице или внесите отсутствующую spec_url в mdn/browser-compat-data. Также убедитесь, что спецификация включена в w3c/browser-specs.
Совместимость браузеров
См. также
© 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/href