# type: Image

图片组件,用来在设备端上通过各类样式属性的应用呈现图片, 支持使用 png、jpg、gif、svg、apng(设备37版本及以上)、webp(设备37版本及以上)格式。

# demo

# props

定义了组件可提供功能和展示效果

名称 类型 默认值 可选值 必填 描述
clickTimeout number 1000 - 图片可被点击的时间间隔,单位毫秒
src string '' - 图片地址
clickable string enable enable,disable 默认图片的可点击态是基于是否有绑定onClick事件,增加这个属性,强制禁用可点击(即使有绑定onClick)
scaleType string fitCenter fitCenter,centerCrop 图片展现方式,铺满且保持原有比例 fitCenter,铺满不保持原有比例有裁剪 centerCrop
loopCount number - 图片为gif、apng格式支持动画方式播放时,可循环播放的次数

# events

名称 参数 参数说明 event说明
onClick - - 图片区域被点击后触发该事件
onImageLoaded - - 图片组件中的图片资源下载完成后触发该事件
onImageEnd - - gif、apng在指定次数的 loopCount 播放完成后触发
onLoaded - - 组件加载完成后可触发该事件(仅在初次渲染完成时触发一次)

# methods

方法名 参数 参数说明 method说明
stopGif - - 停止当前的动图播放
startGif - - 开始动图播放
restartGif - - 重新播放动图

# 组件样例(example)

{
    "type":"Image",
    "componentId": "example-image-background",
    "props": {
        "src":"https://dbp-dict.bj.bcebos.com/dpl%2Fbg-img4.png"
    },
    "styles": {
        "scale-type": "centerCrop",
        "position":"absolute",
        "top":"0dp",
        "left":"0dp",
        "height":"100%",
        "width":"100%"
    }
}