> ## 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>
    メニューから「トグル」を選択します
  </Step>

  <Step>
    トグルのタイトル（常に表示される部分）を入力します
  </Step>

  <Step>
    Enterキーを押してトグル内にコンテンツを作成します
  </Step>
</Steps>

### マークダウンショートカットを使う

キーボードから手を離さずに操作したい場合は、入力しながらブロックをトグルに変換できます：

<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="/ja/write-and-edit/blocks-and-pages">
    Craftの構造を理解する
  </Card>

  <Card title="ドキュメントの書式設定" href="/ja/write-and-edit/styling">
    コンテンツの書式とスタイル
  </Card>

  <Card title="コレクション" href="/ja/organize-and-find/collections">
    構造化データのためのデータベース機能
  </Card>
</CardGroup>