更新记录
1.0.4(2025-03-25) 下载此版本
将微信小程序是否开启长按菜单默认值修改为false
1.0.3(2025-03-13) 下载此版本
更新使用文档
1.0.2(2025-02-12) 下载此版本
修复一点小问题
查看更多平台兼容性
Vue2 | Vue3 |
---|---|
√ | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
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
注意事项
如何阻止事件冒泡
vue2:在组件上直接使用@click.native.stop
,如:<xt-icon @click.native.stop='click'></xt-icon>
;
vue3:由于 vue3 没有native
修饰符,所以不能直接在组件上使用.stop
修饰符,只能嵌套一层view
标签,在外层view
上添加@click.stop
阻止冒泡
基本用法
<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 | false |
是否开启懒加载 |
stop |
Boolean | false |
是否阻止事件冒泡 |
showLoading |
Boolean | true |
是否显示加载中 |
draggable |
Boolean | true |
是否能拖动图片 |
fadeShow |
Boolean | true |
是否开启渐显效果 |
duration |
Number | 0.5 |
渐显效果时间 (单位秒) |
showMenuByLongpress |
Boolean | true |
是否开启长按菜单,仅微信小程序有效 |
preview |
Boolean | false |
是否开启大屏预览 |
@load |
Function | - | 图片加载完成事件 |
@error |
Function | - | 图片加载失败事件 |