Атрибут href задаёт ссылку на ресурс в виде ссылки URL. Точное значение этой ссылки зависит от контекста каждого использующего её элемента.
Примечание: В спецификациях, предшествовавших SVG 2, был определён атрибут xlink:href, который теперь признан устаревшим из-за атрибута href. Если необходимо поддерживать более ранние версии браузеров, устаревший атрибут xlink:href можно использовать в качестве резервного наряду с атрибутом href, например: <use href="some-id" xlink:href="some-id" x="5" y="5" />.
Этот атрибут можно использовать со следующими SVG-элементами:
Для элементов <animate>, <animateMotion>, <animateTransform> и <set> атрибут href задаёт URL, указывающий на элемент, который является целью этого элемента анимации и поэтому будет изменяться со временем.
URL должен указывать ровно на один целевой элемент, который может быть целью данного элемента анимации. Если URL указывает на несколько целевых элементов, если указанный целевой элемент не может быть целью данного элемента анимации или если этот элемент не является частью текущего документа, элемент анимации не повлияет ни на один целевой элемент. Однако элемент анимации продолжит работать в соответствии со своими свойствами синхронизации. В частности, будут отправляться события TimeEvents, а элемент анимации можно будет использовать в качестве syncbase так же, как если бы URL указывал на допустимый целевой элемент.
Если атрибут href или устаревший атрибут xlink:href не указан, целевым элементом будет непосредственный родительский элемент текущего элемента анимации. Если указаны оба атрибута, xlink:href и href, используется значение последнего.
Ограничения на типы элементов, которые могут быть целями определённых типов анимации, описаны в соответствующих разделах об отдельных элементах анимации.
За исключением правил, явно указанных в этой спецификации для SVG, нормативное определение этого атрибута содержится в спецификации анимации SMIL. В частности, см. раздел Анимация SMIL: указание цели анимации.
Для элемента <feImage> атрибут href задаёт URL, указывающий на ресурс изображения или элемент. Если указаны и атрибут xlink:href, и атрибут href, последний имеет приоритет.
Для элементов <linearGradient> или <radialGradient> атрибут href задаёт URL, указывающий на шаблонный элемент градиента; чтобы ссылка была допустимой, она должна вести на другой элемент <linearGradient> или <radialGradient>.
Для элемента <pattern> атрибут href задаёт URL, указывающий на другой элемент <pattern> в текущем SVG-документе. Все атрибуты, заданные для указанного элемента, но не заданные для этого элемента, наследуются этим элементом. Если у этого элемента нет дочерних элементов, а у указанного элемента они есть (возможно, благодаря его собственному атрибуту href), этот элемент наследует дочерние элементы указанного элемента. Наследование может быть косвенным и происходить на произвольном уровне; таким образом, если указанный элемент наследует атрибуты или дочерние элементы благодаря собственному атрибуту href, текущий элемент также может наследовать эти атрибуты или дочерние элементы. У элемента <pattern> атрибут href является анимируемым.
Для элемента <textPath> атрибут href задаёт URL, указывающий на элемент <path> или базовую фигуру, вдоль которой будет отображаться текст, если атрибут path не указан. У элемента <textPath> атрибут href является анимируемым.
Для элемента <use> атрибут href задаёт URL, указывающий на элемент или фрагмент SVG-документа, который нужно клонировать.
Элемент <use> может ссылаться на весь SVG-документ, если указать значение href без фрагмента. Такие ссылки считаются указывающими на корневой элемент указанного документа.
