更新记录

1.0.1(2025-01-23) 下载此版本

优化加载中动画

1.0.0(2025-01-23) 下载此版本

发布初版


平台兼容性

Vue2 Vue3
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 - 图片加载失败事件

说明

  1. 当开启预览后,点击事件在 Vue3 版本中可能会与预览事件同步触发,建议 点击事件 和 预览 两者只绑定一个

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问