Thinking Orb
Canvas 绘制的思考指示球
用法
基础
Loading demo...
渐变
variant="gradient" 给点着色;不传 palette 时每种形态用自己的配色。
Loading demo...
最佳实践
- 每次思考换一颗球:用这次思考的标识作
key;改state不会重新随机。 - 需要确定的画面(截图测试、录屏)时显式传
state。 size只传20或64,其他显示尺寸用displaySize。- 一次思考只挂一颗球。
- 状态文字要和球同色时,从
ORB_PALETTES取色标做文字渐变。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
state | OrbState | 'random' | 'random' | 形态;'random' 在挂载时随机取一次,之后不变。 |
size | 20 | 64 | 20 | 预设几何尺寸,只有这两档经过调校。 |
displaySize | number | 同 size | 渲染的 CSS 尺寸(px),不影响绘制参数。 |
speed | number | 1 | 动画速度倍率。 |
paused | boolean | false | 暂停动画。 |
theme | 'auto' | 'dark' | 'light' | 'auto' | 配色主题;auto 跟随环境。 |
variant | 'mono' | 'gradient' | 'mono' | gradient 给点着色,深浅层次不变。 |
palette | OrbPalette | 形态自带的配色 | 渐变色标,从左到右;不支持 var(),只在 gradient 下生效。 |
label | string | 按形态的英文文案 | 可访问名称;非英文界面需传入。 |
类型
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