> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 折叠块

> 了解如何使用折叠块来收起和展开内容块，让你的文档保持整洁有序。

折叠块是在文档中隐藏和显示内容的强大方式。通过将暂时不需要处理的部分收起，它们可以帮助你保持工作区整洁、专注。

<iframe src="https://www.youtube-nocookie.com/embed/t7bow8G1sNE" title="Craft Toggles Tutorial" className="w-full aspect-video rounded-xl" allowFullScreen />

## 什么是折叠块？

折叠块是一种可折叠的块，用于隐藏或显示其嵌套内容。可以把它想象成手风琴或下拉区 – 你可以点击展开查看内部内容，或将其收起以节省空间。

折叠块非常适合用于：

* 隐藏并非始终需要的详细信息
* 创建常见问题（FAQ）式的文档
* 让参考资料保持可访问但不占据空间
* 管理包含多个章节的长文档
* 创建更简洁的演示和共享文档

## 创建折叠块

在 Craft 中有多种方法可以创建折叠块：

### 使用斜杠菜单

<Steps>
  <Step>
    输入 `/` 以打开斜杠菜单
  </Step>

  <Step>
    搜索 "toggle" 或滚动查找
  </Step>

  <Step>
    从菜单中选择 "Toggle"
  </Step>

  <Step>
    输入折叠块标题（始终可见的部分）
  </Step>

  <Step>
    按 Enter 在折叠块内创建内容
  </Step>
</Steps>

### 使用 Markdown 快捷方式

如果你想让双手始终保持在键盘上，可以在输入时直接将块转换为折叠块：

<Steps>
  <Step>
    将光标置于空白块的开头
  </Step>

  <Step>
    输入加号（`+`）后接一个空格
  </Step>
</Steps>

该块会立即变成折叠块，`+ ` 字符会被移除。输入折叠块标题，然后按 Enter 在其中添加内容。

<Tip>
  这与 Craft 在其他块中使用的快捷方式风格相同，例如用 `-` 加空格创建项目符号列表，或用 `1.` 加空格创建编号列表。
</Tip>

### 将现有内容转换为折叠块

你可以将任何包含嵌套内容的块转换为折叠块：

<Steps>
  <Step>
    点击包含嵌套内容的块
  </Step>

  <Step>
    右键单击（或使用块菜单）
  </Step>

  <Step>
    选择 "转换为折叠块"
  </Step>
</Steps>

该块将变为折叠块，其所有嵌套内容默认被隐藏。

## 展开与收起折叠块

**展开折叠块**：点击折叠块标题旁的箭头图标 (▶)。箭头会向下旋转 (▼)，内容随之显示。

**收起折叠块**：再次点击箭头图标以隐藏内容。

<Info title="键盘快捷键">
  * 将当前块转换为折叠块：`Cmd+Option+7`（macOS）或 `Ctrl+Shift+7`（Windows）
  * 一次性展开或收起文档中的所有折叠块：`Cmd+Option+T`（macOS）或 `Ctrl+Alt+T`（Windows）
</Info>

## 使用嵌套折叠块

折叠块可以包含其他折叠块，从而创建多级可折叠内容。这对于构建层级化的信息结构很有用：

```
▶ Project Overview
  ▶ Phase 1: Planning
    - Requirements gathering
    - Stakeholder meetings
  ▶ Phase 2: Development
    - Sprint 1
    - Sprint 2
```

每个折叠块层级都可以独立展开或收起。

## 使用技巧与最佳实践

* **使用描述性标题。** 标题是唯一始终可见的部分，因此请清晰地说明内部内容。
* **不要过度使用。** 太多折叠块会让文档像迷宫。仅在内容确实可选时使用。
* **考虑分享时哪些内容可见。** 重要信息应无需额外点击即可阅读。
* **与其他功能结合使用。** 折叠块与卡片、列表和标题配合得很好，可用于组织文档结构。

## 将折叠块转换回常规块

如果你决定不再需要折叠块：

<Steps>
  <Step>
    展开折叠块，以便查看其内容
  </Step>

  <Step>
    右键单击折叠块
  </Step>

  <Step>
    选择 "转换为常规块"（或使用"取消分组"）
  </Step>
</Steps>

内容会保留，但将始终可见。

## 何时使用折叠块

当你希望内容被隐藏但能在同一视图中快速访问时，请使用折叠块，例如可选或参考资料、FAQ 答案或补充细节。几种常见模式：

* **会议记录**：议程项保持可见，讨论记录收进折叠块
* **项目文档**：概览始终可见，技术细节放入折叠块
* **学习材料**：题目可见，答案在需要时才显示

当内容值得拥有独立的专属空间以便导航、内容较多且自成体系，或属于更深的层级结构时，请改用页面。

<CardGroup cols={2}>
  <Card title="块和页面" href="/zh-Hans/write-and-edit/blocks-and-pages">
    了解 Craft 的结构
  </Card>

  <Card title="文档样式" href="/zh-Hans/write-and-edit/styling">
    格式化并美化你的内容
  </Card>

  <Card title="集合" href="/zh-Hans/organize-and-find/collections">
    用于结构化数据的类数据库功能
  </Card>
</CardGroup>