> ## 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-Hant/write-and-edit/blocks-and-pages">
    了解 Craft 的結構
  </Card>

  <Card title="文件樣式" href="/zh-Hant/write-and-edit/styling">
    格式化並美化你的內容
  </Card>

  <Card title="集合" href="/zh-Hant/organize-and-find/collections">
    用於結構化資料的類資料庫功能
  </Card>
</CardGroup>