image

图片。

属性名类型默认值说明
srcString图片资源地址,支持云文件ID(2.2.3起)
modeString'scaleToFill'图片裁剪、缩放的模式
lazy-loadBooleanfalse图片懒加载。只针对page与scroll-view下的image有效
binderrorHandleEvent当错误发生时,发布到 AppService 的事件名,事件对象event.detail = {errMsg: 'something wrong'}
bindloadHandleEvent当图片载入完毕时,发布到 AppService 的事件名,事件对象event.detail = {height:'图片高度px', width:'图片宽度px'}
aria-labelString无障碍访问,(属性)元素的额外描述

注1:image组件默认宽度300px、高度225px**注2:image组件中二维码/小程序码图片不支持长按识别。仅在qq.previewImage中支持长按识别。**

mode 有效值:

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

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

示例:

  1. <view class="page">
  2. <view class="page__hd">
  3. <text class="page__title">image</text>
  4. <text class="page__desc">图片</text>
  5. </view>
  6. <view class="page__bd">
  7. <view class="section section_gap" qq:for="{{array}}" qq:for-item="item">
  8. <view class="section__title">{{item.text}}</view>
  9. <view class="section__ctn">
  10. <image
  11. style="width: 200px; height: 200px; background-color: #eeeeee;"
  12. mode="{{item.mode}}"
  13. src="{{src}}"
  14. ></image>
  15. </view>
  16. </view>
  17. </view>
  18. </view>
  1. Page({
  2. data: {
  3. array: [{
  4. mode: 'scaleToFill',
  5. text: 'scaleToFill:不保持纵横比缩放图片,使图片完全适应'
  6. }, {
  7. mode: 'aspectFit',
  8. text: 'aspectFit:保持纵横比缩放图片,使图片的长边能完全显示出来'
  9. }, {
  10. mode: 'aspectFill',
  11. text: 'aspectFill:保持纵横比缩放图片,只保证图片的短边能完全显示出来'
  12. }, {
  13. mode: 'top',
  14. text: 'top:不缩放图片,只显示图片的顶部区域'
  15. }, {
  16. mode: 'bottom',
  17. text: 'bottom:不缩放图片,只显示图片的底部区域'
  18. }, {
  19. mode: 'center',
  20. text: 'center:不缩放图片,只显示图片的中间区域'
  21. }, {
  22. mode: 'left',
  23. text: 'left:不缩放图片,只显示图片的左边区域'
  24. }, {
  25. mode: 'right',
  26. text: 'right:不缩放图片,只显示图片的右边边区域'
  27. }, {
  28. mode: 'top left',
  29. text: 'top left:不缩放图片,只显示图片的左上边区域'
  30. }, {
  31. mode: 'top right',
  32. text: 'top right:不缩放图片,只显示图片的右上边区域'
  33. }, {
  34. mode: 'bottom left',
  35. text: 'bottom left:不缩放图片,只显示图片的左下边区域'
  36. }, {
  37. mode: 'bottom right',
  38. text: 'bottom right:不缩放图片,只显示图片的右下边区域'
  39. }],
  40. src: '../resources/cat.jpg'
  41. },
  42. imageError(e) {
  43. console.log('image3发生error事件,携带值为', e.detail.errMsg)
  44. }
  45. })