# large-image

> 基础库 3.10.3 开始支持，低版本需做[兼容处理](1003706)。

渲染框架支持情况：Skyline （使用最新 [Nightly](/miniprogram/dev/devtools/nightly.html) 工具调试）

## 功能描述

当图片超出设备 GPU 所允许的大小时，应使用  避免图片变形与图片分辨率降低。

## 通用属性


```json
[
  {
    "属性": "src",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "图片资源地址",
    "最低版本": "[3.10.3](1003706)"
  },
  {
    "属性": "mode",
    "类型": "string",
    "默认值": "widthFix",
    "必填": "否",
    "说明": "图片裁剪、缩放的模式",
    "最低版本": "[3.10.3](1003706)",
    "子项": [
      {
        "合法值": "widthFix",
        "说明": "缩放模式，宽度不变，高度自动变化，保持原图宽高比不变",
        "最低版本": ""
      },
      {
        "合法值": "heightFix",
        "说明": "缩放模式，高度不变，宽度自动变化，保持原图宽高比不变",
        "最低版本": "[3.10.3](1003706)"
      }
    ]
  },
  {
    "属性": "bind:load",
    "类型": "eventhandle",
    "默认值": "",
    "必填": "否",
    "说明": "当图片载入完毕时触发，event.detail = {height, width}",
    "最低版本": "[3.10.3](1003706)"
  }
]
```