## 概要

サイドバーフィルターは、サイドバーの上部に表示されるテキスト入力フィールドで、入力に応じてナビゲーション項目をリアルタイムでフィルタリングします。大規模なドキュメントサイトで、サイドバーツリー全体をスクロールせずにページをすばやく見つけるのに役立ちます。

サイドバーフィルターは `create-zudo-doc` で作成されたプロジェクトではデフォルトで有効です。

## 仕組み

フィルター入力はサイドバーの上部、ナビゲーションツリーの上に表示されます。入力すると:

- カテゴリ名と個々のページタイトルの両方がクエリと照合されます
- 大文字小文字を区別しません
- カテゴリ名がマッチした場合、すべての子ページが表示されます
- 子ページのみがマッチした場合、親カテゴリはマッチした子ページだけを表示します
- フィルタリング中、マッチしたカテゴリはすべて自動的に展開されます
- 入力をクリアすると、完全なサイドバーツリーが復元されます

## キーボードショートカット

`Ctrl+/`（Windows/Linux）または `Cmd+/`（macOS）を押すと、ページのどこからでもフィルター入力にフォーカスできます。これはサイドバーが表示されている場合（デスクトップビューポートまたはモバイルサイドバーが開いている場合）に機能します。

## 有効化・無効化

### create-zudo-doc の場合

サイドバーフィルターはデフォルトで有効です。プロジェクト作成時に無効にするには:

```bash
pnpm create zudo-doc my-docs --no-sidebar-filter
```

明示的に有効にするには:

```bash
pnpm create zudo-doc my-docs --sidebar-filter
```

### 既存プロジェクトの場合

フィルターを無効にするには、`sidebarFilter` の機能／設定を使います。新しいプロジェクトでは `--no-sidebar-filter` を渡すか、選択する機能から `sidebarFilter` を外してください。マークアップ変更では、[`chromeBindingsModule`](https://zudo-doc.takazudomodular.com/ja/docs/reference/host-chrome-bindings) 経由で主要 `Sidebar` を置き換えます。入れ子のサイドバー部品を eject する場合、子アイランドをコピーするだけではパッケージのサイドバーは置き換わらないため、CLI の所有者レベル修正案に従ってください。

[Dynamic content unavailable in text export]

ほとんどのドキュメントサイトでは、ページ数が少なくてもサイドバーフィルターは便利です。コンテンツが数十ページを超えると不可欠になります。