# 工具提示 (/zh/components/tooltips)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 188 · updated: 2026-07-30 -->
Related: [折叠面板](/zh/components/accordions.md), [徽章](/zh/components/badge.md), [横幅](/zh/components/banner.md), [标注框](/zh/components/callouts.md), [卡片](/zh/components/cards.md), [代码分组](/zh/components/code-groups.md)

使用工具提示可在用户将鼠标悬停在文本上时提供额外的上下文或定义。工具提示还可以包含可选的行动呼吁链接。

**示例**: <Tooltip headline="API" tip="应用程序编程接口：一组用于使软件应用彼此通信的协议。" cta="阅读我们的 API 指南" href="/zh/api-reference">API</Tooltip> 文档可帮助开发者了解如何将您的服务集成到他们的系统中。

```mdx wrap title="Tooltip example"
<Tooltip headline="API" tip="应用程序编程接口：一组用于使软件应用彼此通信的协议。" cta="阅读我们的 API 指南" href="/api-reference">API</Tooltip> 文档可帮助开发者了解如何将您的服务集成到他们的系统中。
```

<div id="properties">
  ## 属性 [#属性]
</div>

<ResponseField name="tip" type="string">
  悬浮提示中显示的文本。
</ResponseField>

<ResponseField name="headline" type="string">
  显示在 `tip` 文本之前的文本。
</ResponseField>

<ResponseField name="cta" type="string">
  悬浮提示内链接的行动呼吁文本。
</ResponseField>

<ResponseField name="href" type="string">
  行动呼吁链接的URL。使用 `cta` 时为必填。
</ResponseField>