image 图片
收藏我的收藏
收藏基础库 1.0.0 开始支持本组件。
图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式。
属性说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
src | string | 无 | 否 | 图片资源地址。 | 1.0.0 |
mode | string | scaleToFill | 否 | 1.0.0 | |
webp | boolean | false | 否 | 是否解析 webp 格式 | 2.90.0 |
lazy-load | boolean | false | 否 | 图片懒加载，在即将进入 一定范围（上下左右三屏）时才开始加载。 | 1.0.0 |
binderror | EventHandle | 无 | 否 | 当错误发生时触发。 | 1.0.0 |
bindload | EventHandle | 无 | 否 | 当图片载入完毕时触发。 | 1.0.0 |
mode 的合法值
值 | 说明 | 最低支持版本 |
scaleToFill | 缩放模式，不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 img 元素。 | 1.0.0 |
aspectFit | 缩放模式，保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。 | 1.0.0 |
aspectFill | 缩放模式，保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。 | 1.0.0 |
widthFix | 缩放模式，宽度不变，高度自动变化，保持原图宽高比不变。 | 1.0.0 |
heightFix | 缩放模式，高度不变，宽度自动变化，保持原图宽高比不变。 | 1.0.0 |
top | 裁剪模式，不缩放图片，只显示图片的顶部区域。 | 1.0.0 |
bottom | 裁剪模式，不缩放图片，只显示图片的底部区域。 | 1.0.0 |
center | 裁剪模式，不缩放图片，只显示图片的中间区域。 | 1.0.0 |
left | 裁剪模式，不缩放图片，只显示图片的左边区域。 | 1.0.0 |
right | 裁剪模式，不缩放图片，只显示图片的右边区域。 | 1.0.0 |
top left | 裁剪模式，不缩放图片，只显示图片的左上边区域。 | 1.0.0 |
top right | 裁剪模式，不缩放图片，只显示图片的右上边区域。 | 1.0.0 |
bottom left | 裁剪模式，不缩放图片，只显示图片的左下边区域。 | 1.0.0 |
bottom right | 裁剪模式，不缩放图片，只显示图片的右下边区域。 | 1.0.0 |
扫码体验
代码示例
Bug & Tip
- •Tip：img 组件默认的宽度是 300px、高度是 225px;
- •Tip：不支持通过 css 设置图片 height 为 auto，如需实现高度自适应可指定 mode 为 widthFix;
- •Tip：webp 属性为 false 时，iOS 13及以下版本只能解析有.webp 后缀的 webp 图片；其他版本或设置 webp 为 true 后支持任意后缀的 webp 图片。
