内容表

• Usage context
• 属性
• DOM Interface
• 范例
• 规范
• 浏览器兼容性

<image>

1. <ellipse>
2. <image>
3. <line>
4. <path>
5. <polygon>
6. <polyline>
7. <rect>
8. <use>
9. SVG 元素

   1. A
      1. <a>
      2. <altGlyph>
      3. <altGlyphDef>
      4. <altGlyphItem>
      5. <animate>
      6. <animateColor>
      7. <animateMotion>
      8. <animateTransform>
   2. B-C
      1. <circle>
      2. <clipPath>
      3. <color-profile>
      4. <cursor>
   3. D
      1. <defs>
      2. <desc>
   4. E
      1. <ellipse>
   5. F
      1. <feBlend>
      2. <feColorMatrix>
      3. <feComponentTransfer>
      4. <feComposite>
      5. <feConvolveMatrix>
      6. <feDiffuseLighting>
      7. <feDisplacementMap>
      8. <feDistantLight>
      9. <feFlood>
      10. <feFuncA>
      11. <feFuncB>
      12. <feFuncG>
      13. <feFuncR>
      14. <feGaussianBlur>
      15. <feImage>
      16. <feMerge>
      17. <feMergeNode>
      18. <feMorphology>
      19. <feOffset>
      20. <fePointLight>
      21. <feSpecularLighting>
      22. <feSpotLight>
      23. <feTile>
      24. <feTurbulence>
      25. <filter>
      26. <font>
      27. <font-face>
      28. <font-face-format>
      29. <font-face-name>
      30. <font-face-src>
      31. <font-face-uri>
      32. <foreignObject>
   6. G
      1. <g>
      2. <glyph>
      3. <glyphRef>
   7. H
      1. <hkern>
   8. I
      1. <image>
   9. J-L
      1. <line>
      2. <linearGradient>
   10. M
       1. <marker>
       2. <mask>
       3. <metadata>
       4. <missing-glyph>
       5. <mpath>
   11. N-P
       1. <path>
       2. <pattern>
       3. <polygon>
       4. <polyline>
   12. Q-R
       1. <radialGradient>
       2. <rect>
   13. S
       1. <script>
       2. <set>
       3. <stop>
       4. <style>
       5. <svg>
       6. <switch>
       7. <symbol>
   14. T
       1. <text>
       2. <textPath>
       3. <title>
       4. <tref>
       5. <tspan>
   15. U
       1. <use>
   16. V-Z
       1. <view>
       2. <vkern>

<image> SVG element includes images inside SVG documents. It can display raster image files or other SVG files.

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> .

注意： 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

类别	Graphics element, Graphics referencing element
准许内容	Any number of the following elements, in any order: Animation elements Descriptive elements

属性

全局属性

• Conditional processing attributes
• Core attributes
• Graphical event attributes
• Presentation attributes
• Xlink attributes
• class
• style
• transform

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 and xlink:href : Points at a URL for the image file.
• preserveAspectRatio : Controls how the image is scaled.
• crossorigin : Defines the value of the credentials flag for CORS requests.

DOM Interface

<image> 实现 SVGImageElement 接口。

范例

Basic rendering of a PNG image in SVG:

SVG

<svg width="200" height="200"

xmlns



=


"

http://www.w3.org/2000/svg

"



>





<

image


href



=


"

mdn_logo_only_color.png

"



height



=


"

200

"



width



=


"

200

"



/>





</

svg


>



					

结果

规范

规范
Scalable Vector Graphics (SVG) 1.1 (Second Edition) (SVG) # ImageElement

浏览器兼容性

BCD tables only load in the browser

Found a problem with this page?

• Edit on GitHub
• Source on GitHub
• Report a problem with this content on GitHub
• Want to fix the problem yourself? See our Contribution guide .

最后修改： Sep 23, 2021 , 由 MDN 贡献者