StreamingText
渐进展示生成中的文本。中文惯用名：流式文本。
稳定本期新增已接入
元信息
| 字段 | 值 |
|---|---|
| 规范 ID | component.streaming-text |
| 名称 | StreamingText |
| 二级分类 | AI 与会话（ai-chat） |
| 用途 | 渐进展示生成中的文本 |
| 描述 | 中文惯用名：流式文本。 |
预览
静态结构：<span data-slot="streaming-text">（whitespace-pre-wrap）+ 闪烁光标（▍ text-primary animate-pulse，motion-reduce 静止）。两种模式：数据源推送（content 增长 + streaming 光标）与打字机（typing 自揭示完整 content，speed 字符 / 24ms，揭完光标消失）。
DSL 结构
{
"type": "StreamingText",
"props": {
"content": "已为您完成分析。",
"streaming": true
}
}何时用
何时使用
- 渐进展示生成中的文本：流式回答、打字机回放。
何时不用
- 完整 markdown 排版：StreamingText 是纯文本，格式化内容用 Markdown。
变体
| 变体 | 视觉形态 | 适用场景 |
|---|---|---|
| 数据源推送 | content 增长 + 光标 | 真实流式输出 |
| 打字机 | typing 自揭示 | 演示 / 回放 |
API 属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
content | string | '' | 文本内容 |
streaming | boolean | false | 生成中（尾部光标） |
typing | boolean | false | 打字机模式（自揭示） |
speed | number | 2 | 打字机速度（字符 / 24ms） |
className / style | string / CSSProperties | — | 通用：根节点 class 合并 / 内联样式 |
使用规范
- 真实流式用数据源推送模式；typing 仅用于内容已全量的回放。
正例
- ✓ 嵌入式问答：回答文本流式追加，streaming 光标提示生成中。
反例
- ✕ 对流式的 markdown 内容用 StreamingText（应用 Markdown 渲染完整段）。
Design Token 映射
不适用：组件 tokenRefs 为空：样式 Token 数据尚未接入，三层映射（Primitive → Semantic → Component）待样式 Token 接入后回填。