Hyperlink¶
The Hyperlink class represents the SVG a element.
-
class
svgwrite.container.
Hyperlink
(href, target='_blank', **extra)¶ The a element indicate links (also known as Hyperlinks or Web links).
The remote resource (the destination for the link) is defined by a <URI> specified by the XLink xlink:href attribute. The remote resource may be any Web resource (e.g., an image, a video clip, a sound bite, a program, another SVG document, an HTML document, an element within the current document, an element within a different document, etc.). By activating these links (by clicking with the mouse, through keyboard input, voice commands, etc.), users may visit these resources.
A Hyperlink is defined for each separate rendered element contained within the Hyperlink class; add sublements as usual with the add method.
-
Hyperlink.
__init__
(href, target='_blank', **extra)¶ Parameters: - href (string) – hyperlink to the target resource
- target (string) –
'_blank|_replace|_self|_parent|_top|<XML-name>'
- extra – additional SVG attributes as keyword-arguments
SVG Attributes¶
class – string
assigns one or more css-class-names to an element
style – string
allows per-element css-style rules to be specified directly on a given element
externalResourcesRequired – bool
False: if document rendering can proceed even if external resources are unavailable else: True
transform – use
svgwrite.mixins.Transform
interfacexlink:href – string – href parameter
xlink:show –
'new|replace'
use the target attribute
xlink:acuate –
'onRequest'
This attribute provides documentation to XLink-aware processors that an application should traverse from the starting resource to the ending resource only on a post-loading event triggered for the purpose of traversal.
target – string – target parameter
This attribute specifies the name or portion of the target window, frame, pane, tab, or other relevant presentation context (e.g., an HTML or XHTML frame, iframe, or object element) into which a document is to be opened when the link is activated.
_replace
: The current SVG image is replaced by the linked content in the same rectangular area in the same frame as the current SVG image._self
: The current SVG image is replaced by the linked content- in the same frame as the current SVG image. This is the lacuna value, if the target attribute is not specified.
_parent
: The immediate frameset parent of the SVG image is replaced by the linked content._top
: The content of the full window or tab, including any frames, is replaced by the linked content_blank
: A new un-named window or tab is requested for the display of the linked content. If this fails, the result is the same as_top
<XML-Name>
: Specifies the name of the frame, pane, or other relevant presentation context for display of the linked content. If this already exists, it is re-used, replacing the existing content. If it does not exist, it is created (the same as_blank
, except that it now has a name).