导航：首页 > 开发技术 >

微信小程序image组件库怎么用

发表于：2026-11-02 作者：千家信息网编辑

千家信息网最后更新 2026年11月02日，今天小编给大家分享一下微信小程序image组件库怎么用的相关知识点，内容详细，逻辑清晰，相信大部分人都还太了解这方面的知识，所以分享这篇文章给大家参考一下，希望大家阅读完这篇文章后有所收获，下面我们一

千家信息网最后更新 2026年11月02日微信小程序image组件库怎么用

今天小编给大家分享一下微信小程序image组件库怎么用的相关知识点，内容详细，逻辑清晰，相信大部分人都还太了解这方面的知识，所以分享这篇文章给大家参考一下，希望大家阅读完这篇文章后有所收获，下面我们一起来了解一下吧。

微信小程序image

图片。

属性名	类型	默认值	说明
src	String		图片资源地址
mode	String	'scaleToFill'	图片裁剪、缩放的模式
binderror	HandleEvent		当错误发生时，发布到AppService的事件名，事件对象event.detail = { errMsg: 'something wrong' }
bindload	HandleEvent		当图片载入完毕时，发布到AppService的事件名，事件对象event.detail = {height:'图片高度px', width:'图片宽度px' }

注：image组件默认宽度300px、高度225px

mode 有效值：

mode有13种模式，其中4中是缩放模式，9种是裁剪模式。

模式	值	说明
缩放	scaleToFill	不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素
缩放	aspectFit	保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。
缩放	aspectFill	保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
缩放	widthFix	宽度不变，高度自动变化，保持原图宽高比不变
裁剪	top	不缩放图片，只显示图片的顶部区域
裁剪	bottom	不缩放图片，只显示图片的底部区域
裁剪	center	不缩放图片，只显示图片的中间区域
裁剪	left	不缩放图片，只显示图片的左边区域
裁剪	right	不缩放图片，只显示图片的右边区域
裁剪	top left	不缩放图片，只显示图片的左上边区域
裁剪	top right	不缩放图片，只显示图片的右上边区域
裁剪	bottom left	不缩放图片，只显示图片的左下边区域
裁剪	bottom right	不缩放图片，只显示图片的右下边区域

示例：

  image图片      {{item.text}}

Page({  data: {    array: [{      mode: 'scaleToFill',      text: 'scaleToFill：不保持纵横比缩放图片，使图片完全适应'}, {      mode: 'aspectFit',      text: 'aspectFit：保持纵横比缩放图片，使图片的长边能完全显示出来'}, {      mode: 'aspectFill',      text: 'aspectFill：保持纵横比缩放图片，只保证图片的短边能完全显示出来'}, {      mode: 'top',      text: 'top：不缩放图片，只显示图片的顶部区域'}, {      mode: 'bottom',      text: 'bottom：不缩放图片，只显示图片的底部区域'}, {      mode: 'center',      text: 'center：不缩放图片，只显示图片的中间区域'}, {      mode: 'left',      text: 'left：不缩放图片，只显示图片的左边区域'}, {      mode: 'right',      text: 'right：不缩放图片，只显示图片的右边边区域'}, {      mode: 'top left',      text: 'top left：不缩放图片，只显示图片的左上边区域'}, {      mode: 'top right',      text: 'top right：不缩放图片，只显示图片的右上边区域'}, {      mode: 'bottom left',      text: 'bottom left：不缩放图片，只显示图片的左下边区域'}, {      mode: 'bottom right',      text: 'bottom right：不缩放图片，只显示图片的右下边区域'}],    src: '../../resources/cat.jpg'  },  imageError: function(e) {console.log('image3发生error事件，携带值为', e.detail.errMsg)  }})

以上就是"微信小程序image组件库怎么用"这篇文章的所有内容，感谢各位的阅读！相信大家阅读完这篇文章都有很大的收获，小编每天都会为大家更新不同的知识，如果还想学习更多的知识，请关注行业资讯频道。

很赞哦！