Skip to content

Image 图片

基础用法

  • 相比于内置 image 组件更加方便使用。
  • 支持图片加载占位、图片预览、懒加载(同 image 组件)、动画效果(同 image 组件)
  • 默认为 aspectFit 模式。此模式支持根据父容器自动设置图片长宽、给定宽度自动计算长度,设置 height 属性后此功能失效
vue
<sn-image src="https://www.example.com/example.png"></sn-image>

更多演示请下载 demo 查看

属性

参数说明类型默认值可选值
width图片宽度(不填则自动铺满父元素)String--
height图片高度(不填则自动根据 width 和图片内容计算)(不填 width 时也不得填 height,反之则可以)String--
src图片路径(网络路径、本地路径皆可)(本地路径支持 /static/xxx,Android 平台支持file:///xxx 绝对路径以及 Content Provider 的content://xxxString--
mode图片裁剪、缩放方式。StringaspectFitscaleToFill | aspectFit | aspectFill | widthFix | heightFix | top | bottom | center | left | right | top left | top right | bottom left | bottom right
borderRadius图片圆角大小String$small-
loadingBgColor图片加载占位块背景颜色String$info-
loadingIconColor图片加载占位块中的图标颜色String$infoDark-
loadingSize图片加载占位块尺寸String80px-
lazyLoad图片懒加载。只针对page与scroll-view下的image有效。同内置 imageBooleanfalsetrue | false
fadeShow图片显示动画效果。同内置 imageBooleanfalsetrue | false
enablePreview点击后调用内置的 uni.previewImage 进行图片预览Booleanfalsetrue | false
customStyle自定义图片容器样式UTSJSONObject{}-
customImageStyle自定义图片(内置 image)样式UTSJSONObject{}-
customLoadingStyle自定义图片加载占位块样式UTSJSONObject{}-

事件

名称类型说明
error(event: UniImageErrorEvent)加载错误时触发
load(event: UniImageLoadEvent)加载成功时触发
click(event : UniPointerEvent)单击图片时触发
dbclick(event : UniPointerEvent)双击图片时触发
longpress(event : UniTouchEvent)长按图片时触发

使用 MIT 协议