组件/Thinking Orb

Thinking Orb

Canvas 绘制的思考指示球

Verified自 0.3.9

用法

基础

Loading demo...

渐变

variant="gradient" 给点着色;不传 palette 时每种形态用自己的配色。

Loading demo...

最佳实践

  • 每次思考换一颗球:用这次思考的标识作 key;改 state 不会重新随机。
  • 需要确定的画面(截图测试、录屏)时显式传 state。
  • size 只传 20 或 64,其他显示尺寸用 displaySize。
  • 一次思考只挂一颗球。
  • 状态文字要和球同色时,从 ORB_PALETTES 取色标做文字渐变。

API 参考

属性

属性名类型默认值说明
stateOrbState | 'random''random'形态;'random' 在挂载时随机取一次,之后不变。
size20 | 6420预设几何尺寸,只有这两档经过调校。
displaySizenumber同 size渲染的 CSS 尺寸(px),不影响绘制参数。
speednumber1动画速度倍率。
pausedbooleanfalse暂停动画。
theme'auto' | 'dark' | 'light''auto'配色主题;auto 跟随环境。
variant'mono' | 'gradient''mono'gradient 给点着色,深浅层次不变。
paletteOrbPalette形态自带的配色渐变色标,从左到右;不支持 var(),只在 gradient 下生效。
labelstring按形态的英文文案可访问名称;非英文界面需传入。

类型

EXAMPLE.TYPESCRIPT
type OrbState =
  | 'working' | 'searching' | 'solving' | 'listening' | 'connecting'
  | 'weaving' | 'composing' | 'breathing' | 'shaping'

type OrbVariant = 'mono' | 'gradient'

type OrbPaletteName =
  | 'amber' | 'glacier' | 'violet' | 'rose' | 'magenta'
  | 'teal' | 'indigo' | 'lagoon' | 'forest'

// 配色名,或从左到右的 CSS 颜色
type OrbPalette = OrbPaletteName | readonly string[]

// 九组配色,各三个色标;以及每种形态默认的配色
declare const ORB_PALETTES: Record<OrbPaletteName, readonly [string, string, string]>
declare const ORB_STATE_PALETTES: Record<OrbState, OrbPaletteName>

概述

  • 所有已挂载的球共用一个时钟(performance.now),同屏多颗保持同相位。
  • 离屏(IntersectionObserver)或标签页隐藏时停止绘制。
  • 减弱动效时只绘制一帧代表性的静止画面,仍跟随主题切换。
  • 画布按 devicePixelRatio 提升分辨率,上限为 2。
  • 渐变按点的横向位置取色,球转动时颜色随之流动;深色背景下保留原有明暗,近处的点接近白色。
  • 没有 canvas(如 jsdom)时保留元素、跳过绘制,不会抛错。

技术实现

  • 移植自 thinking-orbs v0.2.0(MIT © Jakub Antalik),源码文件头保留署名。
  • 源码:packages/tuffex/packages/components/src/thinking-orb/。
查看源码
packages/tuffex/packages/components/src/thinking-orb/index.ts