更新记录
1.0.1(2025-01-23)
下载此版本
优化加载中动画
1.0.0(2025-01-23)
下载此版本
发布初版
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.1.0 app-vue |
× |
√ |
× |
× |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
× |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
组件名: xt-image
安装方式
本组件符合 easycom 规范,HBuilderX 3.1.0 起,只需将本组件导入项目,在页面 template 中即可直接使用,无需在页面中 import 和注册 components
基本用法
<template>
<view>
<xt-image :src="imageUrl" radius='10rpx' preview></xt-image>
</view>
</template>
<script>
export default {
data() {
return {
imageUrl: 'https://img2.baidu.com/it/u=2957562685,2198634793&fm=253&app=120&size=w931&n=0&f=JPEG&fmt=auto?sec=1737565200&t=fe793276ec3656ef227916ec5572c94e'
}
},
methods: {},
}
</script>
<style lang="scss">
</style>
自定义加载动画
<xt-image :src="imageUrl">
<template #load>
加载中...
</template>
</xt-image>
自定义加载失败内容
<xt-image :src="imageUrl">
<template #error>
加载失败
</template>
</xt-image>
xt-image 属性和方法
属性名 |
类型 |
默认值 |
说明 |
src |
String |
- |
图片地址 |
width |
String |
300rpx |
图片宽度 |
height |
String |
300rpx |
图片高度 |
radius |
String |
- |
图片圆角 |
shape |
String |
square |
图片形状 {square:方形, circle:圆形} |
mode |
String |
scaleToFill |
图片裁剪、缩放的模式 (见官网) |
bgColor |
String |
#dfe4ea |
背景颜色 |
iconColor |
String |
#ced6e0 |
图标颜色 |
webp |
Boolean |
false |
只支持网络资源,仅微信小程序有效 |
lazyLoad |
Boolean |
true |
是否开启懒加载 |
showLoading |
Boolean |
true |
是否显示加载中 |
draggable |
Boolean |
true |
是否能拖动图片 |
fadeShow |
Boolean |
true |
是否开启渐显效果 |
duration |
Number |
0.5 |
渐显效果时间 (单位秒) |
showMenuByLongpress |
Boolean |
true |
是否开启长按菜单,仅微信小程序有效 |
preview |
Boolean |
false |
是否开启大屏预览 |
@load |
Function |
- |
图片加载完成事件 |
@error |
Function |
- |
图片加载失败事件 |
说明
- 当开启预览后,点击事件在 Vue3 版本中可能会与预览事件同步触发,建议 点击事件 和 预览 两者只绑定一个