image
更新时间：2024-11-13 20:32:36
image
图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式
属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| src | string | 图片资源地址 | ||
| mode | string | scaleToFill | 图片裁剪、缩放的模式 | |
| lazy-load | boolean | true | 图片懒加载 | |
| binderror | eventhandle | 当错误发生时触发，event.detail = {errMsg} | ||
| bindload | eventhandle | 当图片载入完毕时触发，event.detail = {height, width} |
mode 的合法值
值 | 说明 |
|---|---|
| scaleToFill | 缩放模式，不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素 |
| aspectFit | 缩放模式，保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。 |
| aspectFill | 缩放模式，保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。 |
| widthFix | 缩放模式，宽度不变，高度自动变化，保持原图宽高比不变 |
| heightFix | 缩放模式，高度不变，宽度自动变化，保持原图宽高比不变 |
| top | 裁剪模式，不缩放图片，只显示图片的顶部区域 |
| bottom | 裁剪模式，不缩放图片，只显示图片的底部区域 |
| center | 裁剪模式，不缩放图片，只显示图片的中间区域 |
| left | 裁剪模式，不缩放图片，只显示图片的左边区域 |
| right | 裁剪模式，不缩放图片，只显示图片的右边区域 |
| top left | 裁剪模式，不缩放图片，只显示图片的左上边区域 |
| top right | 裁剪模式，不缩放图片，只显示图片的右上边区域 |
| bottom left | 裁剪模式，不缩放图片，只显示图片的左下边区域 |
| bottom right | 裁剪模式，不缩放图片，只显示图片的右下边区域 |
扫码预览
组件示例
xhsml
<view class="page-body">
<view class="page-section page-section-gap">
<view class="page-section-title">Local Image</view>
<view class="page-section-ctn">
<image class="image test" src="../../resources/pic/1.jpg"/>
</view>
</view>
<view class="page-section page-section-gap">
<view class="page-section-title">Internet Image</view>
<view class="page-section-ctn">
<image class="image" src="{{imageUrl}}"/>
</view>
</view>
<view class="page-section page-section-gap">
<view class="page-section-title">Webp Image</view>
<view class="page-section-ctn">
<image class="image" webp src="{{webpImageURL}}" mode="aspectFit"/>
</view>
</view>
</view>