Image 图片

该组件封装加强 <image> 组件，除了原有的功能外，添加圆角，占位图等常用功能。

基本使用

通过 <n-image> 形式调用，设置参数 src 显示图片

<n-image src="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dnvue/6462c8c0-4b04-11eb-bdc1-8bd33eb6adaa.jpg"></n-image>

占位图

在图片下载过程中将展示占位图，图片下载完成后将显示src中指定的图片，通过 placeholder 参数进行配置占位图

<n-image placeholder="https://vkceyugu.cdn.bspapp.com/VKCEYUGU-dnvue/3a91f3b0-4b07-11eb-8a36-ebb87efcf8c0.png"></n-image>

#

API

Attribute 属性

属性	说明	类型	可选值	默认值	平台差异说明
src	显示图片的 URL	String	-	-
mode	图片裁剪、缩放的模式	String	参数值	scaleToFill
placeholder	占位图的 URL，在图片下载过程中将展示占位图，图片下载完成后将显示src中指定的图片	String	-	-
width	宽度，默认300rpx	String, Number	-	-
height	高度，默认225rpx	String, Number	-	-
radius	圆角，查看使用方式	Array	[1]、[1,2]、[1,2,3]、[1,2,3,4]	-
recycle	控制当图片滚出屏幕时是否回收相关内存，Android有效	Boolean	false	true	仅App-nvue 2.3.4+ Android有效
fade-show	图片显示动画效果，Android有效	Boolean	true	false	仅App-nvue 2.3.4+ Android有效
lazy-load	图片懒加载。只针对page与scroll-view下的image有效	Boolean	true	false	微信小程序、App、百度小程序、字节跳动小程序
unit	单位置换，只有宽、高参与单位置换：px（html单位值），rpx（uniapp单位值）	String	px	rpx
style-custom	组件自定义样式，同 css 样式。注意带’-‘连接符的属性需要使用小驼峰写法如：backgroundColor:red	Object	-	-

Event 事件

事件名	说明	返回值
@click	点击事件	-
@load	加载成功	图片信息

mode 图片裁剪、缩放的模式

mode 有 13 种模式，其中 4 种是缩放模式，9 种是裁剪模式。

模式	值	说明
缩放	scaleToFill	不保持纵横比缩放图片，使图片的宽高完全拉伸至填满 image 元素
缩放	aspectFit	保持纵横比缩放图片，使图片的长边能完全显示出来。也就是说，可以完整地将图片显示出来。
缩放	aspectFill	保持纵横比缩放图片，只保证图片的短边能完全显示出来。也就是说，图片通常只在水平或垂直方向是完整的，另一个方向将会发生截取。
缩放	widthFix	宽度不变，高度自动变化，保持原图宽高比不变
缩放	heightFix	高度不变，宽度自动变化，保持原图宽高比不变
裁剪	top	不缩放图片，只显示图片的顶部区域
裁剪	bottom	不缩放图片，只显示图片的底部区域
裁剪	center	不缩放图片，只显示图片的中间区域
裁剪	left	不缩放图片，只显示图片的左边区域
裁剪	right	不缩放图片，只显示图片的右边区域
裁剪	top left	不缩放图片，只显示图片的左上边区域
裁剪	top right	不缩放图片，只显示图片的右上边区域
裁剪	bottom left	不缩放图片，只显示图片的左下边区域
裁剪	bottom right	不缩放图片，只显示图片的右下边区域