【微信小程序】Image图片加载(78/100）

lichong951

已于 2025-08-24 20:21:54 修改

阅读量1.6k

点赞数

CC 4.0 BY-SA版权

分类专栏： # 微信小程序文章标签：微信小程序小程序微信小程序断点调试微信开发者工具mac 微信小程序单选框微信小程序怎么打断点调试微信小程序switch

于 2022-07-21 14:54:58 首次发布

本文链接：https://blog.csdn.net/lichong951/article/details/125912349

微信小程序专栏收录该内容

29 篇文章

订阅专栏

在这里插入图片描述
UI布局：

<!--pages/image/image.wxml-->
<view class="page__hd">
    <text class="page__title">image</text>
    <text class="page__desc">图片</text>
  </view>
  <view class="page__bd">
    <view class="section section_gap" wx:for="{{array}}" wx:for-item="item">
      <view class="section__title">{{item.text}}</view>
      <view class="section__ctn">
        <image style="width: 200px; height: 200px; background-color: #eeeeee;" mode="{{item.mode}}" src="{{src}}"></image>
      </view>
    </view>
  </view>

数据模型& 控制

// pages/image/image.js
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: 'https://res.wx.qq.com/wxdoc/dist/assets/img/0.4cb08bb4.jpg'
  },
  imageError: function(e) {
    console.log('image3发生error事件，携带值为', e.detail.errMsg)
  },
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {

  },

功能描述

图片。支持 JPG、PNG、SVG、WEBP、GIF 等格式，2.3.0 起支持云文件ID。

属性说明

属性类型默认值必填说明最低版本
src string 否图片资源地址 1.0.0

mode string scaleToFill 否图片裁剪、缩放的模式 1.0.0
合法值说明最低版本
scaleToFill 缩放模式，不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素
aspectFit 缩放模式，保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。
aspectFill 缩放模式，保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
widthFix 缩放模式，宽度不变，高度自动变化，保持原图宽高比不变

heightFix 缩放模式，高度不变，宽度自动变化，保持原图宽高比不变 2.10.3
top 裁剪模式，不缩放图片，只显示图片的顶部区域
bottom 裁剪模式，不缩放图片，只显示图片的底部区域
center 裁剪模式，不缩放图片，只显示图片的中间区域
left 裁剪模式，不缩放图片，只显示图片的左边区域
right 裁剪模式，不缩放图片，只显示图片的右边区域
top left 裁剪模式，不缩放图片，只显示图片的左上边区域
top right 裁剪模式，不缩放图片，只显示图片的右上边区域
bottom left 裁剪模式，不缩放图片，只显示图片的左下边区域
bottom right 裁剪模式，不缩放图片，只显示图片的右下边区域

webp boolean false 否默认不解析 webP 格式，只支持网络资源 2.9.0

lazy-load boolean false 否图片懒加载，在即将进入一定范围（上下三屏）时才开始加载 1.5.0

show-menu-by-longpress boolean false 否长按图片显示发送给朋友、收藏、保存图片、搜一搜、打开名片/前往群聊/打开小程序（若图片中包含对应二维码或小程序码）的菜单。 2.7.0

binderror eventhandle 否当错误发生时触发，event.detail = {errMsg} 1.0.0

bindload eventhandle 否当图片载入完毕时触发，event.detail = {height, width} 1.0.0

支持长按识别的码
类型说明最低版本
小程序码
微信个人码 2.18.0

企业微信个人码 2.18.0

普通群码指仅包含微信用户的群 2.18.0

互通群码指既有微信用户也有企业微信用户的群 2.18.0

公众号二维码 2.18.0