更新记录

0.0.1(2024-01-17) 下载此版本

完成基本功能,可正常使用 关于兼容性,插件本身是基于three.js的,所以理论上只要小程序平台的canvas支持webgl,就都是可以兼容的


平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
× × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

1.使用示例

<template>
    <view>
        <tk-3d-img @checkedResult="onCheckResult" 
                   :auto-rotate="autoRotate" 
                   :img1="img1Src" 
                   :img2="img2Src" 
                   :img3="img3Src" 
                   :img4="img4Src" 
                   :background-img="backgroundImg">
        </tk-3d-img>
    </view>
</template>
<script>
    export default {
        data() {
            return {
                autoRotate:true,
                img1Src:'https://mmbiz.qpic.cn/mmbiz_jpg/DWsjgNA1bNiaicx3016TfufqmooNeDbYoLd2pxNiaLJVaAdF7SlQ46g6RXx1uEw6ibZa4nbPZ18UsfCSBqUaz0ibykw/640?wx_fmt=jpeg&amp;from=appmsg',
                img2Src:'https://mmbiz.qpic.cn/mmbiz_jpg/DWsjgNA1bNiaicx3016TfufqmooNeDbYoLS2bFH35LlibAO5enI4LibbEHOvicZPYYxV1Ahnrlx7Wd0Vuias9bw1sedQ/640?wx_fmt=jpeg&amp;from=appmsg',
                img3Src:'https://mmbiz.qpic.cn/mmbiz_jpg/DWsjgNA1bNiaicx3016TfufqmooNeDbYoLzPIvWWxT7ATko10iapXwOh9oXFUhXKsgHI41YELLwWr49emHOkGDxfg/640?wx_fmt=jpeg&amp;from=appmsg',
                img4Src:'https://mmbiz.qpic.cn/mmbiz_jpg/DWsjgNA1bNiaicx3016TfufqmooNeDbYoLY5DllyU8CYHVKQubqicBpwtPJrwLicAd9xyGUhLFlfujNY84w7x9XmwA/640?wx_fmt=jpeg&amp;from=appmsg',
                backgroundImg:'https://mmbiz.qpic.cn/mmbiz_jpg/DWsjgNA1bNiaicx3016TfufqmooNeDbYoLrJiaqLyOFtbGurfLbn7w3oV9K0ZKjXvQHChkFOOUoeOuAO3ibgDxIrGg/640?wx_fmt=jpeg&amp;from=appmsg'
            }
        },

        methods: {
            onCheckResult(e){
                console.log('接收到事件:',e)
                uni.showToast({
                    title:e,
                    icon:'none'
                })
            }
        }
    }
</script>

2.代码说明

在需要的界面加入

<tk-3d-img></tk-3d-img>

即可使用本插件。

3.插件属性 Props

(1)图片链接

插件中 img1 , img2, img3 , img4。这4个属性分别代表4张图片的网络链接地址。

可直接通过属性绑定的方式(例如在组件中直接写入图片地址 :img1="xxx.jpg")给属性赋值,

也可以通过在Script中的数据绑定方式,给该属性赋值,

该属性数据类型为String,即赋值时需要给一个字符串。

(2)背景图片

插件中 backgroundImg。代表组件的背景图,不能指定颜色值,只能赋值为图片链接地址。

如果只想给组件一个单色背景,可做一个单色图片作为背景图,将图片链接赋值给本属性。

该属性数据类型为String,即赋值时需要给一个字符串。

(3)图片自动旋转

插件中 autoRotate。代表图片是否自动滚动旋转,默认值为false,也就是不旋转。

如需设置为自动旋转,可直接将该组件属性设置为 true。(例如 :auto-rotate="true")

该属性数据类型为Boolean,即赋值时需要给一个布尔类型的值。

(4) 组件尺寸设置

组件中 canvasWidthcanvasHeight属性,分别代表组件的宽和高,单位是 rpx

宽度默认值750rpx,高度默认值为420rpx。

这个值可以自行修改,但是尽量以16:9的比例去修改,因为图片大小设置的比例为16:9.

该属性数据类型为Number,即赋值时需要给一个数字值。

4.插件方法 method

用户点击了图片后,我们需要知道点击的是那种图片,然后去做相应的交互。

这个是通过 checkedResult 事件实现的,在组件中给该事件绑定一个方法来接受组件传回的信息。如下:

@checkedResult="onCheckResult"

在页面的methods中,实现这个方法。

onCheckResult(e){
    console.log('接收到事件:',e)
    uni.showToast({
        title:e,
        icon:'none'
    })
}

返回的事件值就是点击的图片的属性名(即img1/img2/img3/img4)

然后就可以根据返回值,做进一步的代码编写了(例如跳转相关页面)

5.插件示例

隐私、权限声明

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

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

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

许可协议

MIT协议

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