> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.manicule.dev/zh/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://mintlify.manicule.dev/zh/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://mintlify.manicule.dev/api/mcp.
> Every agent surface: https://mintlify.manicule.dev/.well-known/llms-manifest.json

# 可展开项 (/zh/components/expandables)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 225 · updated: 2026-07-31 -->
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)

> 使用可展开组件在 API 文档中切换嵌套对象属性的显示，展示请求和响应对象的子字段。

使用可展开项在响应字段中显示或隐藏嵌套内容。它们对在 API 文档中展示复杂对象属性尤其有用。

<ResponseField name="user" type="User Object">
  <Expandable title="properties">
<ResponseField name="full_name" type="string">用户的全名</ResponseField>

<ResponseField name="is_over_21" type="boolean">用户是否已满 21 岁</ResponseField>
  </Expandable>
</ResponseField>

```mdx Expandable title="example"
<ResponseField name="user" type="User Object">
  <Expandable title="properties">
    <ResponseField name="full_name" type="string">
      用户的全名
    </ResponseField>

    <ResponseField name="is_over_21" type="boolean">
      用户是否已满 21 岁
    </ResponseField>
  </Expandable>
</ResponseField>
```

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

<ResponseField name="title" type="string">正在显示的对象名称。</ResponseField>

<ResponseField name="defaultOpen" type="boolean" default="false">设为 `true`，使展开项在页面加载时默认打开。</ResponseField>