Reasoning Disclosure
可折叠的推理过程区域
用法
基础
耗时只在 streaming 为假且传了 durationMs 时显示。
Loading demo...
最佳实践
- 默认保持折叠:展开的推理会把回答挤出首屏。
- 流式结束时一并传入
durationMs并把streaming置为false。 - 需要跨会话记住展开状态时,在外层持有状态并用
key重建组件。 - 本地化时同时覆盖
label、thinkingLabel与durationFormatter。 - 正文只渲染纯文本;需要 Markdown 时与
TxStreamMarkdown自行组合。
API 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
text | string | '' | 推理正文,按纯文本渲染并保留换行。 |
streaming | boolean | false | 仍在输出;切换头部文案与图标,正文跟随末尾滚动。 |
durationMs | number | — | 思考耗时(毫秒)。 |
defaultOpen | boolean | false | 初始是否展开,只在挂载时读取。 |
label | string | 'Reasoning' | 结束后的头部文案。 |
thinkingLabel | string | 'Thinking…' | 流式时的头部文案。 |
durationFormatter | (ms: number) => string | — | 自定义耗时文案;缺省为 Thought for X.Xs。 |
事件
| 事件名 | 参数 | 说明 |
|---|---|---|
toggle | (open: boolean) | 点击头部时触发,参数为切换后的状态。 |
概述
- 流式时
text每次变化都把正文滚到底部;非流式时不干预滚动位置。 - 头部是原生
<button>,带aria-expanded与指向正文的aria-controls;图标为aria-hidden。 - 折叠只是收起正文,内容仍挂载在 DOM 中。
技术实现
- 折叠用
grid-template-rows在0fr与1fr之间过渡(0.26 秒),正文始终挂载。 - 流式时标签使用
background-clip: text的光带,1.6 秒循环。 - 源码:
packages/tuffex/packages/components/src/reasoning-disclosure/。
查看源码
packages/tuffex/packages/components/src/reasoning-disclosure/index.ts