组件/Reasoning Disclosure

Reasoning Disclosure

可折叠的推理过程区域

Verified自 0.3.9

用法

基础

耗时只在 streaming 为假且传了 durationMs 时显示。

Loading demo...

最佳实践

  • 默认保持折叠:展开的推理会把回答挤出首屏。
  • 流式结束时一并传入 durationMs 并把 streaming 置为 false。
  • 需要跨会话记住展开状态时,在外层持有状态并用 key 重建组件。
  • 本地化时同时覆盖 label、thinkingLabel 与 durationFormatter。
  • 正文只渲染纯文本;需要 Markdown 时与 TxStreamMarkdown 自行组合。

API 参考

属性

属性名类型默认值说明
textstring''推理正文,按纯文本渲染并保留换行。
streamingbooleanfalse仍在输出;切换头部文案与图标,正文跟随末尾滚动。
durationMsnumber—思考耗时(毫秒)。
defaultOpenbooleanfalse初始是否展开,只在挂载时读取。
labelstring'Reasoning'结束后的头部文案。
thinkingLabelstring'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