.. _cover-image:

:wx_comp:`cover-image`
===========================

.. versionadded:: 1.4.0  低版本需做 :ref:`compatibility` 。

覆盖在原生组件之上的图片视图。可覆盖的原生组件同<:doc:`cover-view`>，支持嵌套在<:doc:`cover-view`>里。

+-----------+-------------+--------+------+------------------------------------------------------------------------------------------------+----------+
| 属性      | 类型        | 默认值 | 必填 | 说明                                                                                           | 最低版本 |
+-----------+-------------+--------+------+------------------------------------------------------------------------------------------------+----------+
| src       | string      |        | 否   | 图标路径，支持临时路径、网络地址（1.6.0起支持）、云文件ID（2.2.3起支持）。暂不支持base64格式。 | 1.4.0    |
+-----------+-------------+--------+------+------------------------------------------------------------------------------------------------+----------+
| bindload  | eventhandle |        | 否   | 图片加载成功时触发                                                                             | 2.1.0    |
+-----------+-------------+--------+------+------------------------------------------------------------------------------------------------+----------+
| binderror | eventhandle |        | 否   | 图片加载失败时触发                                                                             | 2.1.0    |
+-----------+-------------+--------+------+------------------------------------------------------------------------------------------------+----------+