Toast

用短暂通知反馈操作结果或状态变化，支持图标、操作和富内容，适合保存成功、错误与提醒。

我们正在让 SnowUI 组件成为 AI 对话中可直接操作的界面。目前对话交互能力仍在建设中；本页展示网站用法，支持的对话平台与组件版本将在验证后公布。 AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。

如何使用

用于短暂的操作结果反馈，配合 Toaster 管理展示。通知历史、活动记录使用常驻内容列表，不使用 Toast。

调用 toast 发送短暂反馈，由 Toaster 管理队列；独立渲染时页面负责关闭后的移除。
as="toast" 可接入宿主点击触发；leading / trailing 组合附属内容，parts 只配置默认关闭按钮。短标签使用继承的 singleLine 与 Text lines={1}；内部有效间距至少4 CSS px，rich 多行正文保持原布局。

import { Toast } from '@snowui-design-system/components';

属性	类型	默认值	示例	描述
`parts`	`ComponentPartsOf<{ Button: typeof Button }>`	`—`	`parts={partsOptions}`	配置内置关闭 Button 的外观；事件、关闭语义和 ARIA 由 Toast 管理
`id`	`string`	`—`	`id="example"`	静态使用时透传为 DOM id；`template` 模式下作为模板 id，供 `showToast(id)` 激活
`template`	`boolean`	`false`	`template`	模版模式:只注册为命令式 Toast 模板，不直接渲染；用于"一段 Toast 代码 + 一个触发按钮"的写法
`as`	`"toast" \| undefined`	`—`	`as={value}`	内嵌模式(v1.1.0):`as="toast"` 启用 Inline 模式,自动发现宿主父元素并绑定 click 事件触发 Toast。遵循 ComponentGuidelines.md §5 三激活模式规范
`positive`	`boolean`	`—`	`positive`	语义判定：`true`=积极(CheckCircle)；`false`=问题(Warning)；不传则不渲染内置图标
`variant`	`ToastVariant`	`"default"`	`variant={value}`	视觉变体
`size`	`ToastSize`	`"md"`	`size={value}`	仅 default 变体生效
`position`	`ToastPosition`	`"top"`	`position={value}`	用于驱动出入场方向（不直接定位）
`onDismiss`	`() => void`	`—`	`onDismiss={(value) => { /* handle value */ }}`	点击关闭 X 时回调（rich 变体）
`children`	`Snippet`	`—`	`<Toast>Content</Toast>`	正文和 leading / trailing 槽位内容；独立使用时由调用方处理关闭后的移除