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://xxx ) | String | - | - |
mode | 图片裁剪、缩放方式。 | String | aspectFit | scaleToFill | 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 | 图片加载占位块尺寸 | String | 80px | - |
lazyLoad | 图片懒加载。只针对page与scroll-view下的image有效。同内置 image | Boolean | false | true | false |
fadeShow | 图片显示动画效果。同内置 image | Boolean | false | true | false |
enablePreview | 点击后调用内置的 uni.previewImage 进行图片预览 | Boolean | false | true | false |
customStyle | 自定义图片容器样式 | UTSJSONObject | {} | - |
customImageStyle | 自定义图片(内置 image )样式 | UTSJSONObject | {} | - |
customLoadingStyle | 自定义图片加载占位块样式 | UTSJSONObject | {} | - |
事件
名称 | 类型 | 说明 |
---|---|---|
error | (event: UniImageErrorEvent) | 加载错误时触发 |
load | (event: UniImageLoadEvent) | 加载成功时触发 |
click | (event : UniPointerEvent) | 单击图片时触发 |
dbclick | (event : UniPointerEvent) | 双击图片时触发 |
longpress | (event : UniTouchEvent) | 长按图片时触发 |