说明
面向“思维链 / 智能体执行过程”的时间线组件,纯展示、不依赖任何浏览器 API。
常见能力:
- 竖向时间线:状态节点图标随 Status 变化,loading 自动旋转,末项自动断线
- Line 连接线、Collapsible 正文折叠、Collapsed 控制单步初始展开态
- ShowStatus 显示本地化状态标签(等待中 / 思考中 / 已完成 / 失败)
- 每步 Title/Description/Content 分层,Content 为可折叠详细正文(纯 CSS 动画)
- OnStepClick 回传命中步骤,Icon 可覆盖节点图标,宿主改 Status 即驱动进度
- Title / EmptyText 走词条,步骤文本视为业务内容不本地化
- 纯展示、无 JS 互操作、受控数据,明暗主题随 CSS 令牌自动适配
用法
<ThoughtChain Title="智能体推理链" Items="@_steps"
ShowStatus="true" Collapsible="true" OnStepClick="OnStep" />
@code {
List<ThoughtChainStep> _steps = new()
{
new("解析用户意图", "success") { Description = "识别实体与目标", Content = "输入→ 关键要素:客户、金额、时间。" },
new("检索知识库", "loading") { Description = "匹配可复用模板" },
new("生成实体草稿", "pending") { Description = "请求代码生成接口" },
};
void OnStep(ThoughtChainStep s) => Console.WriteLine(s.Title);
}
API 参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Collapsible |
bool |
true |
有正文(Content)的步骤是否可折叠。默认 true;为 false 时正文常显。 |
EmptyText |
string |
"暂无步骤" |
空态文本(作为翻译键)。 |
Items |
List<ThoughtChainStep> |
null |
思维链步骤数据。标题 / 说明 / 正文视为业务内容、直接展示不本地化。 |
Line |
bool |
true |
是否绘制节点之间的连接竖线。默认 true。 |
OnStepClick |
EventCallback<ThoughtChainStep> |
— | 事件 点击某个步骤标题的回调(折叠展开时同样触发)。 |
ShowStatus |
bool |
false |
是否在标题旁显示本地化的状态标签(等待中 / 思考中 / 已完成 / 失败)。默认 false。 |
Title |
string |
null |
整体标题(作为翻译键)。留空则不显示。 |
Visible |
bool |
true |
取得或设置组件是否可见,默认为false。 |
VisibleChanged |
EventCallback<bool> |
— | 事件 取得或设置组件可见性变化时的回调事件。 |
Class |
string |
null |
取得或设置组件的CSS类名,用于自定义样式。 |
Disabled |
bool |
false |
取得或设置组件是否禁用,默认为false。 |
Style |
string |
null |
取得或设置组件的内联样式,用于自定义样式。 |
所有组件均继承
BaseComponent,除上表参数外还支持Class、Style、Disabled、Visible。
扫码关注公众号
扫码加入 QQ 群