# cover-image

目前[原生组件](/miniprogram/dev/component/native-component/native-component)均已支持同层渲染，建议使用 [image](/miniprogram/dev/component/media-component/image) 替代

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

> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

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

## 功能描述

覆盖在原生组件之上的图片视图。

可覆盖的原生组件同[cover-view](/miniprogram/dev/component/view-component/cover-view)，支持嵌套在[cover-view](/miniprogram/dev/component/view-component/cover-view)里。

## 通用属性


```json
[
  {
    "属性": "src",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "图标路径，支持临时路径、网络地址（1.6.0起支持）、云文件ID（2.2.3起支持）。",
    "最低版本": "[1.4.0](1003706)"
  },
  {
    "属性": "referrer-policy",
    "类型": "string",
    "默认值": "no-referrer",
    "必填": "否",
    "说明": "格式固定为 \u0000INLINECODE_0\u0000，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；",
    "最低版本": "[2.13.0](1003706)",
    "子项": [
      {
        "合法值": "origin",
        "说明": "发送完整的referrer"
      },
      {
        "合法值": "no-referrer",
        "说明": "不发送"
      }
    ]
  },
  {
    "属性": "bind:load",
    "类型": "eventhandle",
    "默认值": "",
    "必填": "否",
    "说明": "图片加载成功时触发",
    "最低版本": "[2.1.0](1003706)"
  },
  {
    "属性": "bind:error",
    "类型": "eventhandle",
    "默认值": "",
    "必填": "否",
    "说明": "图片加载失败时触发",
    "最低版本": "[2.1.0](1003706)"
  }
]
```

#### 支持的格式

| 格式    | iOS  | Android |
| ------ | ---- | ------- |
| JPG    | √    | √       |
| PNG    | √    | √       |
| SVG    | x    | x       |
| WEBP   | √    | √       |
| GIF    | √    | √       |
| BASE64 | x    | x       |