纯前端实现的决策转盘与随机抽签工具技术实现

0 阅读10分钟

关键词:决策转盘、随机抽签、Canvas、加密级随机数、纯前端、JavaScript、抽奖


一、背景与需求

在日常生活和工作中,经常需要做选择或进行随机抽取:决定今天吃什么、抽取幸运观众、随机分派任务、课堂点名等。传统的抽签方式(纸条、骰子)效率低且不便于多人现场参与;部分在线抽奖工具需要注册登录、上传数据,或对抽奖次数和人数设限。

基于此,我开发了 Toolion 决策转盘 / 随机抽签工具(项目地址:toolion.cn/decision-wh… 在这里插入图片描述


二、核心功能

功能模块说明
旋转转盘(轮盘抽奖)自定义选项,Canvas 绘制扇形转盘,顺时针旋转随机停止,展示中奖结果
批量抽签从选项列表中随机抽取指定数量(不重复),支持多轮抽取,结果列表展示
自定义选项每行输入一个选项,支持任意数量,选项过多时自动缩小字号与截断显示
加密级随机数优先使用 crypto.getRandomValues 生成随机索引,浏览器不支持时降级为 Math.random
动态重绘修改选项或切换主题时,转盘实时重绘,支持深色/浅色模式
无障碍动效支持 prefers-reduced-motion,减少动画模式下跳过旋转过渡
纯前端本地处理所有计算与绘制在浏览器内完成,选项数据不上传服务器,支持离线运行
免费无需注册打开页面即可使用,无登录、无订阅、无水印

三、技术实现

3.1 整体架构

该工具是一个纯前端单页面应用(单 HTML 文件),未引入 Vue/React 等前端框架,全部逻辑使用原生 JavaScript 实现:

浏览器端(纯原生 JavaScript)
├── 输入层:选项文本域、模式切换(转盘/批量)、批量抽取数量
├── 随机层:crypto.getRandomValues(降级 Math.random)、随机索引生成
├── 绘图层:Canvas 2D 绘制扇形转盘、选项文字、旋转动画
└── 渲染层:转盘画布、指针、中心按钮、结果展示区、批量抽签列表、深色/浅色主题

3.2 加密级随机数

为保证抽签公平性,优先使用 Web Crypto API 生成加密级随机数,避免 Math.random 的可预测性:

function secureRandomInt(max) {
  if (max <= 0) return 0;
  const cryptoObj = window.crypto || window.msCrypto;
  if (cryptoObj && cryptoObj.getRandomValues) {
    const range = Math.floor(0xFFFFFFFF / max) * max;
    const arr = new Uint32Array(1);
    let val;
    do {
      cryptoObj.getRandomValues(arr);
      val = arr[0];
    } while (val >= range);
    return val % max;
  }
  // 降级方案
  return Math.floor(Math.random() * max);
}

关键点:

  • 拒绝采样(Rejection Sampling):通过 range = Math.floor(0xFFFFFFFF / max) * max 舍弃超出范围的随机值,避免模运算导致的概率偏差(modulo bias);
  • 降级兼容:旧版浏览器或不支持 crypto.getRandomValues 的环境自动回退到 Math.random,保证功能可用;
  • 批量抽签时,从副本池中 splice 移除已抽选项,保证不重复抽取。

3.3 Canvas 转盘绘制

转盘使用 HTML5 Canvas 2D API 绘制,根据选项数量等分扇形,每个扇形分配不同颜色,并渲染选项文字:

function drawWheel() {
  const dpr = window.devicePixelRatio || 1;
  const wrap = canvas.parentElement;
  const size = wrap.offsetWidth;
  if (size === 0) return;

  canvas.width = Math.round(size * dpr);
  canvas.height = Math.round(size * dpr);
  ctx.setTransform(dpr, 0, 0, dpr, 0, 0);

  const center = size / 2;
  const radius = center - 4;
  ctx.clearRect(0, 0, size, size);

  // 无选项时显示提示
  if (options.length === 0) {
    // ... 绘制空白圆与提示文字
    return;
  }
  // 仅一个选项时特殊处理
  if (options.length === 1) {
    // ... 绘制单色圆与提示
    return;
  }

  const arc = (Math.PI * 2) / options.length;
  const showText = options.length <= 24;
  const isDense = options.length > 12;

  for (let i = 0; i < options.length; i++) {
    const angle = i * arc;

    // 画扇形(避免相邻颜色相同)
    ctx.beginPath();
    let colorIdx = i % colors.length;
    if (i > 0 && colorIdx === (i - 1) % colors.length) {
      colorIdx = (colorIdx + 1) % colors.length;
    }
    ctx.fillStyle = colors[colorIdx];
    ctx.moveTo(center, center);
    ctx.arc(center, center, radius, angle, angle + arc);
    ctx.fill();

    if (!showText) continue;

    // 画旋转后的选项文字
    ctx.save();
    ctx.translate(center, center);
    ctx.rotate(angle + arc / 2);
    ctx.textAlign = 'right';
    ctx.textBaseline = 'middle';
    ctx.fillStyle = '#fff';
    let fontSize = 16;
    if (isDense) fontSize = 12;
    if (options.length > 20) fontSize = 10;
    ctx.font = 'bold ' + fontSize + 'px sans-serif';

    let text = options[i];
    let maxChars;
    if (isDense) {
      maxChars = Math.max(3, Math.floor(options.length > 20 ? 4 : 6));
    } else {
      maxChars = Math.max(6, Math.floor(radius / (fontSize * 0.9)));
    }
    if (text.length > maxChars) text = text.substring(0, maxChars) + '…';
    ctx.fillText(text, radius - 20, 0);
    ctx.restore();
  }
}

关键点:

  • 设备像素比(DPR):canvas.width = size * dpr,配合 ctx.setTransform(dpr, ...),在高分屏下保持清晰;
  • 颜色避免重复:相邻扇形若颜色索引相同,则偏移一位,提升视觉区分度;
  • 文字自适应:选项数量超过 12 时缩小字号,超过 24 时不显示文字,避免拥挤;长文本自动截断并添加省略号;
  • CSS 变量读取:Canvas 不支持 var(--color),通过 getComputedStyle(document.documentElement).getPropertyValue(name) 读取 CSS 变量的真实颜色值,用于空状态背景与文字色。

3.4 旋转动画与角度归一化

点击“开始抽奖”后,计算目标扇区角度,施加 5 圈完整旋转加目标偏移,通过 CSS transition 实现平滑顺时针旋转;动画结束后归一化角度,避免二次反向补间:

function spin() {
  if (isSpinning) return;
  if (options.length === 0) { /* 提示 */ return; }
  if (options.length === 1) { /* 提示 */ return; }

  isSpinning = true;
  // ... 禁用按钮与输入

  const targetIndex = secureRandomInt(options.length);
  const arcDeg = 360 / options.length;
  const targetDeg = targetIndex * arcDeg + arcDeg / 2;

  // 指针位于顶部(-90 度),计算目标最终角度
  let baseRotation = (360 - targetDeg + 270) % 360;
  const currentBase = currentRotation % 360;
  let diff = baseRotation - currentBase;
  if (diff < 0) diff += 360;

  const circles = 5;
  const finalRotation = currentRotation + (circles * 360) + diff;

  // 触发顺时针旋转
  canvas.style.transform = 'rotate(' + finalRotation + 'deg)';

  let finished = false;
  function finishSpin() {
    if (finished) return;
    finished = true;
    canvas.removeEventListener('transitionend', onTransitionEnd);

    // 关键:归一化角度时禁用过渡,防止从 finalRotation 反向过渡回小角度
    canvas.style.transition = 'none';
    currentRotation = finalRotation % 360;
    canvas.style.transform = 'rotate(' + currentRotation + 'deg)';
    void canvas.offsetWidth; // 强制 reflow
    canvas.style.transition = '';

    isSpinning = false;
    // ... 恢复按钮与输入
    resultText.textContent = '🎉 ' + options[targetIndex];
    resultText.classList.add('winner');
  }

  function onTransitionEnd(e) {
    if (e.target === canvas && e.propertyName === 'transform') {
      finishSpin();
    }
  }

  if (prefersReducedMotion) {
    setTimeout(finishSpin, SPIN_DURATION); // SPIN_DURATION = 100ms
  } else {
    canvas.addEventListener('transitionend', onTransitionEnd);
    setTimeout(finishSpin, SPIN_DURATION + 200); // SPIN_DURATION = 4000ms,兜底
  }
}

关键点:

  • 顺时针统一旋转:修复了早期版本中“顺时针转完后逆时针倒转”的问题,动画始终顺时针;
  • 角度归一化:动画结束后 currentRotation = finalRotation % 360,并在 transition: none 状态下立即应用,避免浏览器对超大角度产生反向补间动画;
  • 双重兜底:优先监听 transitionend,同时设置 setTimeout 兜底,防止 transition 事件未触发导致按钮长期禁用;
  • 减少动效模式:prefers-reduced-motion 匹配时,旋转时间缩短至 100ms 并跳过过渡,尊重用户无障碍偏好。

3.5 批量抽签逻辑

批量模式下,从选项副本池中按指定数量随机抽取,不重复,结果以动画列表形式展示:

btnBatchDraw.addEventListener('click', () => {
  options = parseOptions();
  if (options.length === 0) { alert('请先输入选项!'); return; }

  let count = parseInt(batchCount.value, 10);
  if (isNaN(count) || count < 1) count = 1;
  if (count > options.length) {
    count = options.length;
    batchCount.value = count;
    alert('抽取数量已自动调整为选项总数 ' + count);
  }

  const pool = options.slice();
  const results = [];
  for (let i = 0; i < count; i++) {
    const randomIndex = secureRandomInt(pool.length);
    results.push(pool.splice(randomIndex, 1)[0]);
  }

  const displayCount = Math.min(results.length, 100);
  const html = results.slice(0, displayCount).map((res, idx) =>
    '<div class="batch-item" style="animation-delay:' + (idx * 0.05) + 's">' +
    '<span class="idx">第 ' + (idx + 1) + ' 抽</span>' +
    '<span class="val">' + escapeHtml(res) + '</span>' +
    '</div>'
  ).join('');
  batchList.innerHTML = html;
});

关键点:

  • 不重复抽取:pool.splice(randomIndex, 1) 每次抽取后移除该选项,保证同一轮不重复;
  • 数量自动截断:若用户请求的抽取数量超过选项总数,自动调整为选项总数并提示;
  • 结果展示上限:最多展示前 100 项,超出部分提示总抽取数量;
  • XSS 防护:结果文本通过 escapeHtml 转义 & < > " ',防止选项内容注入 HTML。

3.6 选项解析与主题适配

function parseOptions() {
  return optionInput.value.split('\n')
    .map(l => l.trim())
    .filter(l => l.length > 0);
}
  • 选项按换行符分割,去除首尾空白,过滤空行;
  • 修改选项时实时重绘转盘,旋转过程中禁止编辑;
  • 深色/浅色主题通过 CSS 变量切换,主题改变后重绘 Canvas 以更新空状态背景与文字颜色,状态持久化到 localStorage。

四、关键技术挑战与解决方案

挑战解决方案
抽签结果需公平不可预测优先使用 crypto.getRandomValues 加密级随机数,拒绝采样消除模偏差,不支持时降级为 Math.random
高分屏下 Canvas 模糊按 devicePixelRatio 设置 canvas 实际尺寸,配合 setTransform(dpr, ...) 缩放上下文
相邻扇形颜色相同影响辨识相邻扇形若颜色索引相同则偏移一位
选项过多导致文字拥挤超过 12 项缩小字号,超过 24 项不显示文字,长文本截断并添加省略号
旋转动画结束后角度反向补间归一化时先设置 transition: none 应用角度,强制 reflow 后再恢复过渡
transitionend 事件未触发导致卡死双重兜底:监听 transitionend 并设置 setTimeout 兜底
减少动效用户体验prefers-reduced-motion 匹配时缩短旋转时间并跳过过渡
选项内容注入 HTML批量结果展示前通过 escapeHtml 转义特殊字符
纯前端无后端依赖所有随机、绘图、逻辑在浏览器本地完成,选项不上传服务器

五、使用示例

场景 1:决定今天吃什么(旋转转盘)

  1. 打开 https://toolion.cn/decision-wheel/,保持“旋转转盘”模式;
  2. 在选项列表输入:吃火锅、吃烤肉、吃日料、吃快餐、吃面条(每行一个);
  3. 点击“开始抽奖”或点击转盘中心“抽”按钮;
  4. 转盘顺时针旋转 5 圈后停止,指针指向的选项即为结果,右侧展示“🎉 吃日料”。

场景 2:从 20 名员工中随机抽取 3 名获奖者(批量抽签)

  1. 切换到“批量抽签”模式;
  2. 输入 20 名员工姓名,每行一个;
  3. 抽取数量设为 3;
  4. 点击“立即抽签”,结果列表展示第 1、第 2、第 3 抽的中奖者,不重复。

场景 3:深色模式下使用

  1. 点击右上角主题切换按钮,切换为暗色模式;
  2. 转盘背景与文字颜色自动适配,继续抽奖。

注意事项:

  • 选项数量建议控制在 24 项以内,超过后选项文字将不显示,仅靠颜色扇形区分;
  • 批量抽签最多展示前 100 项,若选项数量极大,建议分多轮抽取;
  • 所有数据仅在本地处理,页面刷新后选项将丢失,建议抽奖前记录重要选项。

六、免责声明

本文仅提供技术实现分享,相关工具仅供学习与日常便利使用,不构成任何商业建议。抽签结果基于浏览器随机数生成器,虽使用加密级随机数但不适用于涉及重大法律或财务风险的正式抽奖场景,重要场景请使用受监管的抽奖方式。所有数据仅在浏览器本地内存中处理,不上传服务器,页面关闭后即从内存释放。


七、总结

本文介绍了一种纯前端实现的决策转盘与随机抽签方案。核心设计思路:

  1. 加密级随机数:crypto.getRandomValues + 拒绝采样,保证抽签公平性,降级兼容旧浏览器;
  2. Canvas 转盘绘制:等分扇形、自适应颜色与字号、长文本截断,支持高 DPR 高分屏;
  3. 旋转动画:5 圈完整旋转加目标偏移,顺时针统一,角度归一化避免反向补间,支持 prefers-reduced-motion;
  4. 批量不重复抽取:副本池 splice 移除,数量自动截断,结果 XSS 转义;
  5. 隐私优先:全部处理在浏览器本地完成,选项不上传服务器,无需登录,免费使用;
  6. 主题适配:CSS 变量深色/浅色模式,主题切换后重绘 Canvas。

该方案适合需要轻量级、纯前端随机决策与抽签能力的场景,可作为前端互动类工具页面的技术参考。


#决策转盘 #随机抽签 #抽奖转盘 #Canvas #加密级随机数 #纯前端 #JavaScript #本地处理 #隐私安全 #工具开发 #随机决定