Tabs
代替手順や言語別の例などの選択肢を並べて表示し、読者が必要なものを選べるようにします。
2026年11月19日更新
Tabsは、同じ内容の複数のバージョンのうち1つを表示します。読者はタブをクリックして切り替えると、残りの内容は表示されなくなります。
Homebrewでインストールします:
brew install acme<Tabs>
<Tab title="macOS">
Install with Homebrew:
```bash
brew install acme
```
</Tab>
<Tab title="Linux">
Install with your distribution's package manager:
```bash
sudo apt install acme
```
</Tab>
<Tab title="Windows">
Install with winget:
```powershell
winget install acme
```
</Tab>
</Tabs>
仕組み
<Tabs>ブロック内に、選択肢ごとに<Tab>を1つずつ配置します。各タブのtitleがそのラベルになります。ページを読み込むと、最初のタブが開いた状態で表示されます。
タブには、ページに置けるあらゆるものを入れられます。段落、リスト、コードブロック、コールアウト、さらには他のコンポーネントも入れられます。
https://api.acme.com/v1にリクエストを送信します。
<Tabs>
<Tab title="REST">
Send requests to `https://api.acme.com/v1`.
<Callout type="tip">
Every endpoint accepts and returns JSON.
</Callout>
</Tab>
<Tab title="GraphQL">
Send queries to `https://api.acme.com/graphql`.
</Tab>
</Tabs>
ページ上の各タブセットは、それぞれ独立して切り替わります。あるタブセットでタブを選んでも、他のタブセットは変わりません。
プロパティ
Tabs
<Tabs>はプロパティを取りません。内部に<Tab>ブロックを配置します。
Tab
| プロパティ | 型 | デフォルト | 説明 |
|---|---|---|---|
title | string | Tab 1, Tab 2, … | タブのラベルです。指定しない場合は、位置に応じて番号が付けられます。 |
Tabsとコードグループの使い分け
すべてのタブがコードブロックだけで構成されている場合は、代わりにコードグループを使用してください。コードグループはタブをコードブロックのヘッダーバーに配置し、表示中のタブ用にコピーボタンを1つ追加します。
ビジュアルエディターでの操作
/と入力してTabsを選ぶと、2つのタブを持つブロックが挿入されます。タブをクリックすると内容を編集できます。**+**を使ってタブを追加し、タブの横にあるボタンで、アクティブなタブの名前変更、左右への移動、削除を行えます。タブをダブルクリックして名前を変更したり、ドラッグして並べ替えたりすることもできます。