目录

image

图片。

起始版本:1.0.0

约束与限制

image组件默认宽度320px,高度240px。

属性

名称

类型

默认值

必填

描述

src

string

-

是

图片资源地址。支持线上资源和本地资源,支持png,jpg,jpeg,gif,svg,bmp,webp。

mode

string

scaleToFill

否

图片裁剪、缩放的模式。详细内容参见“mode合法值说明”。

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

裁剪模式,不缩放图片,只显示图片的右下边区域。

示例

hxml文件

<view>
  <view has:for="{{array}}" has:for-item="item">
    <view>{{item.text}}</view>
    <view>
      <image
        style="width: 200px; height: 200px; background-color: #eeeeee"
        mode="{{item.mode}}"
        src="{{src}}"
      ></image>
    </view>
  </view>
</view>

js文件

Page({
  data: {
    array: [
      {
        mode: "scaleToFill",
        text: "scaleToFill:不保持纵横比缩放图片,使图片完全适应",
      },
      {
        mode: "aspectFit",
        text: "aspectFit:保持纵横比缩放图片,使图片的长边能完全显示出来",
      },
      {
        mode: "aspectFill",
        text: "aspectFill:保持纵横比缩放图片,只保证图片的短边能完全显示出来",
      },
      {
        mode: "widthFix",
        text: "widthFix:宽度不变,高度自动变化,保持原图宽高比不变",
      },
      {
        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://www.example.com/example.jpg", // 此处仅为样例,请开发者更换为可用图片资源地址
  },
  binderror: function (e) {
    console.log("加载失败");
  },
  bindload: function (e) {
    console.log("加载完成");
  },
});