Skip to content
On this page

image

图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式。

也可以使用<img>

Props

参数类型默认值必填说明
srcstring图片地址
lazy-loadbooleanfalse懒加载
modestringscaleToFill图片裁剪、缩放的模式
合法值说明
scaleToFill不保持纵横比缩放图片,使图片的宽高完全拉伸至填满 image 元素
aspectFit保持纵横比缩放图片,使图片的长边能完全显示出来。可以完整地将图片显示出来
aspectFill保持纵横比缩放图片,只保证图片的短边能完全显示出来。图片通常只在水平或垂直方向是完整的, 另一个方向将会发生截取
widthFix缩放模式,宽度不变,高度自适应,保持原图宽高比不变
heightFix缩放模式,高度不变,宽度自适应,保持原图宽高比不变
top裁剪模式,不缩放,只显示图片的顶部区域
bottom裁剪模式,不缩放,只显示图片的底部区域
center裁剪模式,不缩放,只显示图片的中间区域
left裁剪模式,不缩放,只显示图片的左边区域
right裁剪模式,不缩放,只显示图片的右边区域
topleft裁剪模式,不缩放,只显示图片的左上边区域
topright裁剪模式,不缩放,只显示图片的右上边区域
bottoleft裁剪模式,不缩放,只显示图片的左下边区域
bottomright裁剪模式,不缩放,只显示图片的右下边区域
webpbooleanfalse如果使用网络 webp 资源,则需要设置 true。本地 webp 资源不需要设置。

Example

vue
<template>
  <image src="../assets/test.png"></image>
  <image lazy-load src="https://example.com/test.png"></image>
  <!-- or -->
  <img src="https://example.com/test.png" />
</template>