---
title: Reasoning Disclosure
description: 可折叠的推理过程区域
category: AiReasoning
status: beta
since: 0.3.9
tags: [ai, reasoning, disclosure]
syncStatus: reviewed
verified: true
---

## 用法

### 基础
耗时只在 `streaming` 为假且传了 `durationMs` 时显示。
::::TuffDemoWrapper{demo="ReasoningDisclosureReasoningDisclosureDemo" code-lang="vue"}
---
code: |
  <template>
    <TxReasoningDisclosure streaming text="正在拆解这个问题…" />

    <TxReasoningDisclosure
      :duration-ms="4200"
      default-open
      text="先确认输入边界，再挑选算法。"
    />
  </template>
---
::::

### 最佳实践

- 默认保持折叠：展开的推理会把回答挤出首屏。
- 流式结束时一并传入 `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/`。

<TuffDocSourceLink />
