image
O elemento SVG <image>
carrega imagens dentro de documentos SVG. Ele pode exibir arquivos raster image ou outros arquivos SVG.
The only image formats SVG software must support are JPEG, PNG, and other SVG files. Animated GIF behavior is undefined.
SVG files displayed with <image>
are treated as an image: external resources aren't loaded, :visited styles aren't applied, and they cannot be interactive. To include dynamic SVG elements, try <use> with an external URL. To include SVG files and run scripts inside them, try <object> inside of <foreignObject>.
Nota: The HTML spec defines <image>
as a synonym for <img> while parsing HTML. This specific element and its behavior only apply inside SVG documents or inline SVG.
Usage context
Categorias | Elemento gráfico, Elemento gráfico referenciado |
---|---|
Conteúdo permitido | Qualquer número dos seguintes elementos, em qualquer ordem: Elementos de animação Elementos descritivos |
Attributes
Global attributes
Specific attributes
x
: Positions the image horizontally from the origin.y
: Positions the image vertically from the origin.width
: The width the image renders at. Unlike HTML's<img>
, this attribute is required.height
: The height the image renders at. Unlike HTML's<img>
, this attribute is required.href
andxlink:href
: Points at a URL for the image file.preserveAspectRatio
: Controls how the image is scaled.
DOM Interface
<image>
implements the SVGImageElement
interface.
Example
Basic rendering of a PNG image in SVG:
SVG
<svg
width="200"
height="200"
xmlns="https://www.w3.org/2000/svg"
xmlns:xlink="https://www.w3.org/1999/xlink">
<image href="mdn_logo_only_color.png" height="200" width="200" />
</svg>
Result
Especificações
Specification |
---|
Scalable Vector Graphics (SVG) 2 # ImageElement |
Compatibilidade com navegadores
BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.