#image 图片
# image 图片 更新时间：2025-07-30 11:13:33
基础库1.1.0开始支持,低版本需做兼容处理
开发者工具1.22.0开始支持
图片。支持 JPG、PNG、SVG、GIF 等格式。
# 属性 属性 类型 默认值 必填 说明 src string '' 否 图片资源地址 mode 'center' | 'scaleToFill' | 'aspectFit' | 'aspectFill' | 'widthFix' | 'heightFix' | 'top' | 'bottom' | 'left' | 'right' | 'top left' | 'top right' | 'bottom left' | 'bottom right' 'scaleToFill' 否 图片裁剪、缩放的模式 lazy-load boolean false 否 图片懒加载，在即将进入一定范围（上下三屏）时才开始加载 binderror (e: { detail: { errMsg: string } } & Event) => void 否 当错误发生时触发，event.detail = {errMsg} bindload (e: { detail: { height: number, width: number } } & Event) => void 否 当图片载入完毕时触发，event.detail = {height, width} # mode 图片裁剪、缩放的模式
值 说明 'center' 裁剪模式，不缩放图片，只显示图片的中间区域 'scaleToFill' 缩放模式，不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素 'aspectFit' 缩放模式，保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来 'aspectFill' 缩放模式，保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取 'widthFix' 缩放模式，宽度不变，高度自动变化，保持原图宽高比不变 'heightFix' 缩放模式，高度不变，宽度自动变化，保持原图宽高比不变 'top' 裁剪模式，不缩放图片，只显示图片的顶部区域 'bottom' 裁剪模式，不缩放图片，只显示图片的底部区域 'left' 裁剪模式，不缩放图片，只显示图片的左边区域 'right' 裁剪模式，不缩放图片，只显示图片的右边区域 'top left' 裁剪模式，不缩放图片，只显示图片的左上边区域 'top right' 裁剪模式，不缩放图片，只显示图片的右上边区域 'bottom left' 裁剪模式，不缩放图片，只显示图片的左下边区域 'bottom right' 裁剪模式，不缩放图片，只显示图片的右下边区域 tip：image 组件默认宽度 300px、高度 240px tip：image 组件中二维码/小程序码图片不支持长按识别。仅在 ks.previewImage 中支持长按识别 # 扫码体验 # 示例代码