/vue-lottery

:art: vue(2.x \ 3.x) 抽奖以及截屏保存图片至本地

Primary LanguageTypeScript

简介

基于vue.js(3.x)抽奖项目,截屏保存每次抽奖图片至本地,附带背景音乐

技术栈: vue3.x + pinia + vue-router4.x + element-plus + @vueuse/core + axios + mockjs + html2canvas + nprogress + scss + typescript

基于vue.js(2.x)版本,可切换分支查看feature-vue2

欢迎star or fork 关注!

说明

注意:本项目内使用 node-sass,由于该强依赖 nodejs 版本,具体可看 node-sass 指南; 本项目内,安装 node-sass@4.14 版本,与之匹配 node@14 版本,请特别注意。 如已安装 node 版本与 node-sass 不匹配,请重新安装node版本,或将 node-sass 替换成 dart-sass。

示例地址

点击查看

实现思路

本项目主要有以下几个点需要注意

  1. 为了保证数据安全,需要设置登录,在登录成功之后的前提下获取后台传递的数据,以及回传数据也需要验证是否已登录;

  2. 这里利用mockjs来模拟数据,考虑正式抽奖的数据都上千条,cookie和storage存储空间受限都不够用,依次考虑利用浏览器支持的indexDB来存储用户数据库,以及主要奖项和该奖项抽取的人数的;

  3. 每次抽奖完成的结果,须返回给后台存储数据,以保障前后台数据一致性(实现具体抽奖的逻辑功能,不受限,取决于前后台同事自己沟通结果,本示例前端实现抽取,在src/views/lottery文件内);

  4. 记录单次抽奖人数,不论抽多少次,只要满足本轮奖项人数,即宣告本轮抽取结束,代码逻辑不以抽取多少次为依据;

  5. 同时每次抽中的用户数据需要三步处理:

    A. 回传至后台;

    B. 同步至本地indexDB,防止当前页刷新时丢失已抽中用户数据,再一次进入抽奖池;

    C. 截取抽奖屏幕图,用于事后比对;

  6. 考虑抽奖现场肯定会加抽奖项的环节(不多说,参与过年会的都知道,没抽中的人肯定会叫喊老板现场再抽的),故可以在后台设置其他将,人数为空(若为空。前端会默认设置抽取99人,毕竟加抽的奖项人数,99人足够啦,),或者更多,这里也可灵活变动;

配置文件

数据的构造,参照如下代码结构:

// 抽奖数据
data: {
  // 用户
  userData: [
    {
      Company: '公司测1',
      CompleteID: '1',
      HeadImg: 'http://test.baoxianadmin.com/static/m/images/headImage/1.jpg',
      Name: '测1',
      Num: 'M1',
      OpenID: '1',
      Award: '0'
    },
    {
      Company: '公司测13',
      CompleteID: '13',
      HeadImg: 'http://test.baoxianadmin.com/static/m/images/headImage/13.jpg',
      Name: '测13',
      Num: 'M13',
      OpenID: '13',
      Award: '0'
    }
  ],
  // 奖项
  type: [
    {value: '9', label: '特等奖', number: '3'},
    {value: '1', label: '一等奖', number: '5'},
    {value: '2', label: '二等奖', number: '12'},
    {value: '3', label: '三等奖', number: '20'},
    {value: '4', label: '参与奖', number: '28'},
    {value: '5', label: '其他', number: ''}
  ]
}

本项目配置文件位于src/utils/config,按照注释相应地修改对应项就好。

// global config 注意: 所有接口均为mock测试,项目中需要自己替换
const config = {
  // 1.登录页
  login: {
    // 登录请求地址
    url: '/zt_lottery/login',
    // 检测登陆状态
    checkUrl: '/zt_lottery/check_login',
    state: {
      // 当前公司提示语
      msg: '民太安集团年会抽奖系统',
      form: {
        username: 'mta2018',
        trigger: 'blur',
        show: true
      }
    }
  },
  // 2.加载数据页
  onload: {
    // 获取数据地址
    url: '/zt_lottery/list_member',
    // 参与限制人数
    limit: 100
  },
  // 3.中奖活动页
  lottery: {
    // 回传中奖数据地址
    url: '/zt_lottery/add',
    state: {
      // 样式
      style: {
        // 主背景图
        bg: { // 在请求资源路径时,需要require
          backgroundImage: `url(${require('../assets/images/background.png')})`,
          backgroundRepeat: 'no-repeat',
          backgroundSize: '100% 100%'
        },
        // 当前抽奖年
        year: {
          show: false,
          img: require('../assets/images/2017.png')
        }
      },
      // 是否需要下载抽奖截图
      download: {
        show: false,
        delay: 800
      },
      // 滚动间隔
      intervalTime: 50,
      // 绑定键盘事件
      keyBand: {
        start: 'Enter',
        stop: 'Space'
      }
    }
  },
  // 4.全局state状态
  state: {
    // indexDB名称
    DBname: 'lottery2022',
    // indexDB版本
    DBver: '1',
    // indexDB存储表名称
    storeName: {
      user: 'user', // 用户
      award: 'type' // 奖项
    },
    // 背景音乐
    music: {
      show: false,
      src: require('../assets/media/shiji.mp3')
    },
    // 参与规则
    rule: {
      show: true,
      img: require('../assets/images/QR-code.jpg')
    }
  }
}

功能

  1. 抽奖前,选择需要抽取的奖项
  2. 点击开始抽奖按钮(或Enter回车键),数据滚动
  3. 点击抽取(或space空格键)结束滚动,显示中奖人员
  4. 再点击开始抽取进入第2步循环,若完成本轮抽取,则进入第1步选择抽取其他奖项

截图

一。界面截图:

针对1920*1080大屏设计显示,当然也适配其他PC端,以下为该项目主要界面截图:

登录界面 数据加载界面 抽奖界面

二。抽奖截屏:

截屏示例

自动保存的抽奖截图文件至本地思路:

  1. 实现的流程逻辑在src/utils/screenshot文件中;
  2. 由于浏览器browser不支持node.js的模块fs读写文件,因而本示例采用html2canvas来完成截图功能,具体的使用自行百度或谷歌;
  3. 截完屏,最主要的是需要自动保存至本地,利用a标签的download和herf属性可以实现,通过在结束时,自动调用click的事件来触发;
  4. 注意:可能在截屏功能下,出现没有将头像获取下来情况,经查阅资料发现,是由于头像采用的mockjs模拟的,而项目代码部署在另外一个服务器,因而出现跨越情况导致此情况出现,解决办法:前端在html2canvas中添加参数 ==> 允许跨域:allowTaint: true,同时服务器需要允许跨越,即设置 CORS

开发

git clone https://github.com/renmingliang/vue-lottery.git

依赖安装

yarn install

开发调试

yarn serve

编译构建

yarn build

eslint & fix

yarn lint