更新记录
1.0.1(2025-01-07)
下载此版本
更新readme
1.0.0(2025-01-06)
下载此版本
完成骰子样式和动作
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.1.0 |
× |
√ |
× |
× |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
× |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
× |
× |
× |
× |
√ |
× |
√ |
√ |
× |
3D 骰子组件 README
组件介绍
threed-dice
是一个用于显示 3D 骰子的 Vue 组件,支持自定义大小、随机旋转角度以及是否滚动等属性。该组件可以用于游戏、抽奖等场景。
属性说明
属性名 |
类型 |
默认值 |
描述 |
value |
Number |
1 |
骰子当前显示的点数(1-6)。 |
size |
Number |
100 |
骰子的宽度和高度(单位:rpx),控制骰子的整体大小。 |
randomY |
Number |
5 |
骰子在 Y 轴上的随机旋转角度范围(单位:deg),用于增加视觉上的随机性。 |
rolling |
Boolean |
false |
是否处于滚动状态,为 true 时会添加 roll 类名以触发 CSS 动画效果。 |
使用示例
<template>
<view>
<threed-dice
:value="currentValue"
:size="diceSize"
:randomY="randomDegree"
:rolling="isRolling"
></threed-dice>
</view>
</template>
<script setup>
import { ref } from "vue";
import threedDice from "./path/to/threed-dice.vue";
const currentValue = ref(4); // 设置初始点数
const diceSize = ref(120); // 设置骰子大小
const randomDegree = ref(10); // 设置随机旋转角度
const isRolling = ref(true); // 设置是否滚动
</script>
预览图和演示地址
注意事项
value
属性应确保在 1 到 6 之间。
size
属性决定了骰子的大小,请根据页面布局合理设置。
randomY
属性用于增强视觉效果,建议不要设置过大以免影响用户体验。
rolling
属性配合 CSS 动画使用,可实现骰子滚动的效果。