更新记录
1.0.10(2025-02-10)
下载此版本
提供图片懒加载距离
1.0.9(2025-02-10)
下载此版本
添加图片懒加载
1.0.8(2025-02-06)
下载此版本
优化
查看更多
平台兼容性
uni-app
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-nvue |
Android |
iOS |
鸿蒙 |
| √ |
√ |
√ |
√ |
√ |
- |
- |
- |
- |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
快应用-华为 |
快应用-联盟 |
| - |
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |
其他
提供功能
- app 图片缓存
- h5&app图片懒加载
使用方式
<template>
<view>
<xiaoming-image-cache :src="imageUrl" name='name-1' />
<xiaoming-image-cache :src="imageUrl2" name='name-2' />
</view>
</template>
<script setup>
import { ref } from 'vue';
const imageUrl = ref('https://web-ext-storage.dcloud.net.cn/ask/ad/adv_right_2/DCloud%E5%B9%BF%E5%91%8A%E4%BD%8DBanner-02.jpg');
const imageUrl2 = ref('https://qiniu-web-assets.dcloud.net.cn/unidoc/zh/multiport-20210812.png');
</script>
props
| 属性 |
默认值 |
说明 |
必填 |
| src |
无 |
图片地址 |
是 |
| name |
无 |
缓存唯一值 |
推荐 |
| loadingClassName |
xiaoming-image-cache-loading |
图片加载中的className |
否 |
| errorClassName |
xiaoming-image-cache-error |
图片加载失败的className |
否 |
| lazyLoad |
true |
懒加载(传递了scrollTop才有用) |
否 |
| openTransition |
true |
开启过度显示 |
否 |
| showMenuByLongpress |
false |
微信特有 |
否 |
| scrollTop |
0 |
Page或者scrollView的滚动距离(和lazyLoad配合用) |
否 |
| onReachBottomDistance |
100 |
图片距离底部开始加载的距离(单位px) |
否 |
注意
- h5支持,但是不支持缓存
- name属性可选,但是强烈推荐(必须唯一),可以在图片路径发生变化时候,移除本地图片,避免缓存过大
- 支持uniapp组件image的所有属性
- mode默认为"scaleToFill"
- 推荐一次性赋予有效src,不要替换