定价

Toast 更新日志

v2.3.3 (2026-10-23)

  • 通知内部图文和独立文字区域的有效间距至少4 CSS px，根字号及间距缩小时仍保留下限；已有更大间距保持。短标签组合可通过继承的 singleLine 与 Text lines={1} 保持单行并提供截断全文；rich 的复杂多行正文不自动转成单行。

  • 2026-09-21：统一使用文档、源码属性表与 Site / AI 阅读入口；仅文档修订，不改变组件行为。

v2.3.2 (2026-07-05)

修复

  • 按外置 Icon 替换协议检测 Toast 的直系 leading 子项；存在外置 as="leading" 时不再渲染内置 CheckCircle / Warning，修复 TS-04 同时显示两个图标的问题。

v2.3.0 (2026-06-18)

样式调整

  • default 变体新增 backdrop-filter: blur(var(--size-10)) 与 WebKit 前缀，背景模糊档位与共享浮层面板一致。

  • rich 变体在 Toaster 的 idle 层不再覆盖为不透明 Background/1，统一保留 .snowui-quick-action-panel 提供的 Background/3 + blur(var(--size-10))。该调整选择玻璃效果优先，允许堆叠后层内容通过半透明背景产生轻微透出。

  • Toaster 不再使用独立 slot / measure 包装层承接动效。Toast 根元素自身同时承接堆叠 translate / scale、生命周期 transform、组合 opacity、背景与 backdrop-filter，避免外置 blur plate 在内容淡入淡出时单独暴露为灰色层。

  • 单层结构中的透明度直接合并进 Frame fade 配置：appear 为 [80% × stackOpacity, stackOpacity]，disappear 为 [stackOpacity, 80% × stackOpacity]。默认第 2 层稳定态 0.8、第 3 层 0.6，退场终值分别为 0.64 / 0.48；不复用会与 Frame blur motion 冲突的 filter 属性。

  • 移除已无消费方的 --snowui-toast-idle-background-override。

v2.2.0 (2026-05-15)

新增

  • 内嵌模式 as="toast":Toast 作为宿主子节点(如 Button),自动发现父元素并绑定 click 事件触发,无需 id 与手动 showToast。遵循 ComponentGuidelines.md §5 浮层组件三激活模式规范。Toast 三模式齐备:面板 / 内嵌 / 模版。

  • 新增 TS-30 / TS-31 示例覆盖 Inline 模式 default / rich 变体。

v2.1.0 (2026-05-11)

修复

  • Toast 可见栈任一层 hover 时暂停同位置所有可见层自动消失计时，离开 hover 后按剩余时间恢复；后层仍不显示 X。

  • Toaster measure 层显式承接 --su-motion-transform / --su-motion-opacity，修复普通退场缺少位移动效的问题。

  • Toaster idle 层 rich 背景曾改为不透明 --background-1，用于避免后层 Toast 内容透出；该历史策略已在 v2.3.0 撤回。

  • 超过 maxVisible 时，当前最后一层 Toast 进入 pushed-out 状态，沿入场方向继续位移并渐隐，形成“被新层挤出”的专属退出动效。

  • Toaster 移除 document.startViewTransition 更新包装，避免浏览器级过渡队列在动效过程中阻塞按钮连续触发。

  • Toaster 将外层槽位用于堆叠 transform / opacity，内层 Frame 用于出现与退场，避免 appear/disappear transform 覆盖堆叠位移。

  • 退场残影修复采用“双层 transform”方案：内层 Frame 保持 translateY(±100%) 的稳定退场动效，外层 slot 在 exiting / pushed-out 时额外平移 index * gap + offset + 20px，不要把 calc(±100% ± offset ± 20px) 写进内层 whileDisappear。

  • 将 Toaster 堆叠槽位从普通 div + animate:flip 改为 Frame/Frame，堆叠 transform / opacity 过渡统一消费 Frame motion。

  • dismissToast() 改为先标记 exiting 并进入 Disappear 状态，退出动效结束后再移除队列项，避免 Toast 瞬间消失。

  • Frame 新增 currentState 受控状态入口，并让 Appear / Disappear 状态在 Frame inline motion 中实际输出动效样式。

  • 默认停留时长、区域宽度、堆叠 gap、缩放系数、隐藏规则与 top/bottom 滑入滑出方向对齐 HeroUI。

  • 新增通用动效原子与组合预设，不使用 Toast 专属命名：slide / fade / scale / stackTranslate；Toast 侧按需组合为 slideFromTop / slideToTop 等具体用法。

v2.0.0 (2026-05-11)

破坏性变更

  • 移除 <Toast> 的 title / description / icon 三个 prop；所有文字与槽位结构改为 children 外置

  • 新增 <Toast> 的 positive?: boolean prop:true=CheckCircle(积极)、false=Warning(问题)、undefined=不显示内置图标

  • toast() 命令式 API 同步:title/description/icon → text + positive;字符串语法仍可用,等价 { text }

  • 移除 ToastIconKind 类型导出

修复

  • 修复 .snowui-toast-builtin-icon 选择器从未匹配的问题:Icon 组件 class 落在内层 .snowui-icon 上(不是直接子代),选择器由 > 改为后代;且改用 Icon 暴露的 --snowui-icon-width/height-override 闭环覆盖默认 1rem 尺寸 → sm/md 现在正确区分(16/20)

  • 修复"外置 Icon 替换内置图标"规则失效:按 LayoutProtocol §4.1.5 重写为 :has(~) + :has(.builtin) 形式(对齐 SearchInput),精准命中内置 wrapper

v1.0.0 (2026-05-10)

新功能

  • 初始实现：<Toast> 视觉单元 + <Toaster> 全局 Portal + toast() 命令式 API

  • 三槽位 Leading / Content / Trailing；内置 CheckCircle / Warning 支持外置 Icon 替换

  • default（深色玻璃 pill，sm / md）与 rich（白底卡片，复用 .snowui-quick-action-panel）两个变体

  • 6 个出现位置（top / top-left / top-right / bottom / bottom-left / bottom-right），默认 top；距边缘 40px

  • 自动消失（默认 3 秒）+ 同位置堆叠 + animate:flip 平滑前移（历史实现，已在 v2.1.0 被 Frame 槽位方案替代）

  • 出入场动效使用显式组合的 slide + fade + scale；生命周期状态仍由 Frame 的 Appear / Disappear 承接