Gradient 更新日志
2026-09-21:统一使用文档、源码属性表与 Site / AI 阅读入口;仅文档修订,不改变组件行为。
圆角边缘修复(2026-09-15)
radius="50%"使用椭圆路径,正方形时为精确圆形;其他显式圆角使用inset(0 round …)跟随公开圆角值裁切完整合成结果;继承圆角时使用border-box,替换overflow: hidden的圆角裁切,保留 alpha mask 的整体合成,减少圆形轮廓的采样毛边;支持radius与 Avatar 继承圆角。
v2.13.2 (2026-09-15)
动态图层在原始设计坐标中运动后整体适配宽高,修复横向画布左上角露底;保留配色、路径及动画参数;普通 Subtract 2 安全区扩到 800 × 800 以覆盖最小缩放时的四角,其余图层与 Avatar 缓存尺寸不变,不引入尺寸观察器。
v2.13.1 (2026-08-16)
将普通 Gradient 最上方的 Subtract 2 预栅格安全区从
600 × 600扩到720 × 720,避免图层旋转 / 缩放时左上角露出带硬边的底层色块;其他三层维持原画布尺寸,不扩大其合成面积。
v2.13.0 (2026-08-15)
将四个带 Gaussian Blur 的实时 SVG
<g>改为模块级缓存的透明 SVG 图片源;浏览器只在图片解码时生成 blur,运行中的四个 HTML 合成图层只执行 transform,避免 Safari 每帧重栅格滤镜。普通 Gradient 使用
600 × 600overscan 与每段90级更新密度;Avatar 增强幅度使用720 × 720overscan 并保留原有连续缓动。两者均保留柔和路径、公开幅度和时长覆盖。全部实例共享一个
IntersectionObserver;离开视口128px预热范围后暂停内部动画并释放will-change,能力缺失时保持原有持续动效。
v2.12.1 (2026-08-15)
将六组固定 SVG palette、中心色与 Avatar 模式多色 Overlay 正式登记为专业艺术色例外,并明确例外不扩展到 Gradient 的其他样式契约。
v2.12.0 (2026-08-06)
为 Avatar 内部协议提供共享静态图源与受控 hover 生命周期;默认头像常态由 Avatar 直接渲染静态图,Gradient 只在 hover 或常驻 motion 时实例化。
受控 hover effect 只追踪 Avatar 传入的激活值;实例内部的 profile、挂载状态与退出计时更新不参与 effect 依赖,避免循环更新。
静态 Avatar 图片增加 lazy loading、异步解码与低请求优先级,减少长列表首屏解码竞争。
v2.11.0 (2026-08-03)
四层 transform 从2–3个姿态扩展为各自七个不等时、非镜像途经点,闭环末段不再沿上一段原路返回。
新增六组相位 / 方向组合;每次 Avatar hover 随机选择且避开上一次组合,使相同头像重复进入时也不会从同一状态、同一方向开始。
随机只发生在 hover 边界;活动图层数量、filter 数量、CSS逐帧执行方式和退出回收策略保持不变。
v2.10.0 (2026-08-02)
默认 Gradient Avatar 常态继续使用缓存静态图,hover 时才按需挂载一份实时 SVG;离开以0.5秒淡出并连同四组 filter 与 Overlay 一起释放。
四个内部图层改用
6.4s / 7.2s / 8.4s / 6.8s独立线性周期与负延迟错峰,hover 幅度提升到18%位移、30度旋转和32%缩放 / 形变,消除同步缓动造成的长停顿感。修正按需 hover 生命周期接入 Frame 支持的
mouseenter / mouseleave,同时保留外部 pointer 回调透传。
v2.9.0 (2026-08-02)
Gradient Avatar 每种候选色的 Overlay 从四层降为两层,入口缓冲由0.5秒延长为1秒,退出保持0.5秒;颜色、
overlay混合、10秒循环和单层58%峰值不变。默认静态 Avatar 改为复用六份包内 SVG 图片资源,移除200头像场景中的800个实例级 filter 节点并消除重复 data URI;与原实时 SVG 的24px截图像素完全一致。
保留 hover 按需挂载和
content-visibility,单头像 hover 现在只创建10个 pass与10个颜色层。
v2.8.6 (2026-08-02)
保留认可版本 hover 的五色 × 四层 Overlay、
overlay混合、10s 循环、0.5s 缓冲与颜色参数,只将完整结构改为 hover 按需挂载、离开淡出后卸载。Avatar 模式增加原生
content-visibility: auto与绘制 containment,长列表视口外不绘制静态 SVG;不使用逐头像 IntersectionObserver。
v2.8.5 (2026-08-02)
新增
motion基础形变开关:普通 Gradient 默认开启,Avatar fallback 默认关闭。关闭基础形变时不挂载 transform animation 与
will-change;Avatar hover 的认可版本多色 Overlay 保持不变。
v2.8.4 (2026-08-02)
修复 Avatar hover 颜色层在循环边界反复闪烁:关键帧
100%opacity 从错误的1恢复为与0%相同的0.58。五组错峰颜色层现在均以完全相同的起止状态闭环,相邻颜色仍保持连续交叉淡化。
v2.8.3 (2026-08-02)
修复 SVG clip / filter 合成上下文导致
mix-blend-mode: overlay退化为近似纯色染色的问题。双层颜色 Overlay 从 SVG
<g>移到完整 SVG 上方的 HTML 合成层,使每次混合都以原 Gradient 图形作为 backdrop,保留其明暗与渐变纹理。
v2.8.2 (2026-08-02)
修复双层纯色峰值为 100% 时压平原 Gradient 纹理的问题:两层改为独立 Overlay pass,单层峰值限制为 58%。
根据“颜色变化太快”将五色循环时长由
5s增加为10s;每个相邻颜色拥有更长的交叉淡化时间,不发生离散跳色。
v2.8.1 (2026-08-02)
Avatar hover Overlay 的显现时长由
0.15s调整为0.5s,使用标准 ease-in-out 缓动,让双层颜色强度与 5s 循环运动自然渐入。动画仍在 hover 时直接以目标速度运行,但由合成层渐显遮蔽启动跳变,不增加 JavaScript 调速、计时器或逐帧计算。
v2.8.0 (2026-08-02)
Avatar 每个候选色从单层 Overlay 改为两层完全同步的同色 Overlay,每层分别使用
overlay混合,增强色调变化。五色循环由
10s缩短为5s,颜色过渡速度提高至 2 倍。单个头像仅增加到十个纯色 opacity 层,仍不复制 Gaussian Blur 图形。
v2.7.0 (2026-08-02)
Avatar 继续统一提供 hover 状态,Gradient 改为自行管理颜色变化:排除当前 variant 后,将其余五色按实例打乱并持续交叉过渡。
删除旋转 / 缩放的
screen渐变带,改用六种 Gradient 的中心主色作为固定overlay叠加色。为避免复制完整静态 Gradient 带来的 Gaussian Blur 开销,候选色只渲染为五个 80px 纯色矩形且仅动画 opacity。
v2.6.0 (2026-08-02)
GD-04 改为六个
80 × 80Avatar,逐一展示 blue、cyan、green、red、orange、purple 六种 Gradient fallback。Gradient 在 Avatar fallback 模式下按 seed 稳定选择配色;显式 variant 仍拥有最高优先级。
Avatar hover 新增持续的
screen颜色叠加带,只动画小尺寸叠加层的 transform;reduced-motion 下停止循环并保留静态颜色反馈。
v2.5.0 (2026-08-02)
将 GD-05 全部 19 项动效参数初始化为各自可调范围上限:基础时长
60s、整体速度4×、缓动坐标均为1,位移12%、旋转20deg、缩放 / 形变25%。Gradient 公开 CSS fallback 同步为上述上限组合;基础时长与速度换算后的默认实际循环时长为
15s。
v2.4.0 (2026-07-30)
底色矩形改为始终静止,删除整张 SVG 的统一 transform 动画。
四个有色模糊图层分别采用位移 / 旋转、位移 / 缩放、位移 / 非等比形变、位移 / 旋转 / 缩放,并错开关键帧节奏。
为控制性能,颜色、混合模式、路径与 Gaussian Blur 全部保持静态;GD-05 更新为四列排列的 19 项控制。
v2.3.0 (2026-07-30)
增强 A/B/C 默认位移,并将默认旋转幅度调整为
±3deg、缩放幅度调整为5%,使4×速度下仍能清楚辨认持续动效。Rotate / Scale 从逐关键帧绝对值改为整体变化幅度;时间线自动生成对应的负幅度、中心值与正幅度。
GD-05 精简为 14 条控制条,以固定四列网格排列在图形下方。
v2.2.1 (2026-07-30)
GD-05 新增唯一一条整体速度倍率 Slider,默认
1×、范围0.1×–4×。整体速度只换算最终循环时长,不增加第二条动画或 Gradient 运行时脚本。
v2.2.0 (2026-07-30)
将时长、缓动和 A/B/C 三个关键帧的 X、Y、Scale、Rotate 全部落成 CSS override。
GD-05 通过 Test 专用
GradientMotionController增加 17 条控制条,可实时调整全部动效参数;控制状态不进入 Gradient 运行时。
v2.1.0 (2026-07-30)
增加持续柔和的低频漂移动效。
单实例只动画 SVG 根层
transform,不逐帧重算 Gaussian Blur、路径或颜色。默认循环时长为
24s,支持--snowui-gradient-motion-duration-override外部覆盖。prefers-reduced-motion: reduce下停止循环并恢复静态设计基线。
v2.0.1 (2026-07-30)
根层增加纯 alpha mask,修复带 SVG filter 的内容在圆角
overflow边缘出现有色毛边的问题。
v2.0.0 (2026-07-30)
破坏性重写
删除旧版 Workshop 图层
cPNG 渲染与355 × 355静态裁切方案。按 Workshop Frame 200 重绘六种
360 × 360SVG 矢量配色。新增
variant="blue|cyan|green|red|orange|purple"。默认尺寸调整为
360 × 360,默认圆角调整为0。删除无视觉作用的
seed兼容参数。SVG 模糊随 viewBox 几何同步缩放。
静态阶段显式关闭 Frame 默认动效。