关键字:快乐,转盘,微信小程序,weixin,小程序,js,组件,微信组件,wxss
项目名称:快乐转一转转盘微信小程序
项目介绍
快乐转盘微信小程序,是微信小程序转盘自定义组件实现方案,结合项目实际源码,将转盘封装为微信小程序自定义组件,适配多选项、动态数据、状态锁、动画、样式,同时兼容项目本地缓存数据。可以很方便的将组件代码引入微信小程序源码直接使用即可。零门槛非常友好。
如果你在开发转盘类小程序不妨来试试,玩一下,学习学习。
扩展修改方式
修改选项数量:修改 options 数组长度,组件自动均分角度
调整旋转速度/圈数:修改 wheel-anim 动画时长、@keyframes 内旋转角度
修改配色:编辑 wheel-view.wxss 中背景色、按钮色、指针色
修改命中角度:JS 中修改 250 这个固定角度值
常见问题排查
转盘不刷新:检查父页面 options 数据是否正常变化,组件 observers 监听已自动刷新
可重复点击:确认 isRotating 状态锁生效,动画期间状态为 true
结果为空:保证选项角度包含 250°,选项数量建议 8 个
样式错位:真机预览,rpx 单位已做移动端适配
项目结构目录
项目主要技术框架
3.1核心底层框架
该微信项目采用微信小程序原生框架开发,基于微信官方提供的 MINA 框架构建,遵循小程序 MVVM 架构模式,适配微信全版本客户端,兼容安卓与 iOS 双端设备。开发门槛低、运行轻量,无需服务器部署即可实现核心交互,适合快速开发与上线,具备良好的兼容性与稳定性。
3.2后端技术栈
本项目为轻量前端小程序,无复杂后端服务,核心逻辑采用前端本地数据驱动,无需独立后端接口,运行依赖微信客户端环境,部署便捷、维护简单。
3.3前端技术栈
•基础框架:微信小程序原生框架
•开发工具:VSCode、TREA、微信开发者工具
•页面渲染:WXML + WXSS + JavaScript
•适配能力:响应式布局,兼容不同尺寸手机屏幕
3.4开发及生产环境
•系统环境:Windows 10、Windows 7
•开发工具:VSCode /TREA、微信开发者工具
•运行环境:微信客户端(小程序模式)
•部署方式:微信小程序后台上传发布
项目主要功能
1. 组件能力
解耦复用:标准自定义组件,项目内任意页面可直接引用
动态数据:通过 options 属性接收外部数据,选项变化自动刷新转盘
状态锁:isRotating 禁止旋转过程重复点击,避免动画异常
随机逻辑:基于洗牌算法打乱选项,固定 250° 为命中位置,结果随机可控
事件回调:旋转结束通过 rotateEnd 事件向父组件回传结果,对接历史记录
全机型适配:动态获取屏幕宽度,适配不同尺寸手机
2. 动画参数
动画时长:5s
旋转圈数:5 圈(1800deg)
缓动函数:cubic-bezier(0.17, 0.67, 0.13, 0.99),实现先加速后减速的自然惯性效果
结果动画:文字闪烁提醒,增强交互感知
3. 默认数据
默认转盘主题为「今天吃什么?」,包含 8 个美食选项:
米饭、面条、炒菜、火锅、烧烤、麻辣烫、汉堡、寿司
项目安装和部署
5.1 开发环境准备
1.安装微信开发者工具
2.安装 VSCode 或 WebStorm 编辑器
3.配置项目基础文件与目录结构
5.2 项目导入
1.打开微信开发者工具,选择 “导入项目”
2.选择源码目录,填写小程序 AppID(可使用测试号)
3.加载完成后即可预览与调试
5.3 运行与预览
1.在微信开发者工具中点击 “编译”
2.模拟器实时展示页面效果
3.可真机扫码预览,测试真实设备交互
5.4 发布部署
1.调试无误后,在开发者工具点击 “上传”
2.登录微信公众平台,提交代码审核
3.审核通过后发布上线,用户可搜索使用
这个系统实际效果图片展示
这个源码适合的学习人群
该项目代码结构清晰、注释规范、无过度封装、轻量化易上手,极其适合四类人群学习:Java后端初学者、微信小程序开发学习者、计算机专业在校学生、个人开源项目爱好者。
这个项目源码获取方式
关注公众号,回复: 快乐转盘