正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

ファイルツリーブラウザー

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

この機能の利用可能性は機能フラグによって制御されます。詳細については、履歴を参照してください。

ファイルツリーブラウザーは、リポジトリのファイルとディレクトリを折りたたみ可能なツリー構造で表示するドロワーです。これを使用すると、長いファイルリストをスクロールせずにリポジトリ内を移動できます。

ファイルツリーブラウザーは、以下に役立ちます:

  • ネストされたディレクトリ構造のナビゲート。
  • リポジトリ階層の表示。
  • ディレクトリ構造のコンテキストを維持しながら、ファイルの切り替え。

ファイルツリーブラウザーの表示または非表示

ファイルツリーブラウザーを表示または非表示にするには、次の手順に従います:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. /<project>/-/tree/<branch>にあるリポジトリファイルに移動します。
  3. 左上隅で、ファイルツリーブラウザーのアイコン（ file-tree ）を選択します。

Shift+Fを押して、ファイルツリーブラウザーを切り替えることもできます。

ファイルツリーブラウザーには、展開および折りたたむことができるファイルとディレクトリを含むリポジトリの構造が表示されます。

ファイルツリーブラウザー内をナビゲートするには、次の手順に従います:

  1. ファイルツリーブラウザーを開きます。次のいずれかの操作を行います:

    • 左上隅で、ファイルツリーブラウザーのアイコン（ file-tree ）を選択します。
    • Shift+Fを押します。

  2. ディレクトリを展開するには、ディレクトリ名の横にある chevron-right を選択します。

  3. ファイルを表示するには、ファイル名を選択します。

ネストされたファイルに直接移動すると、ファイルツリーブラウザーは親ディレクトリを自動的に展開し、現在のファイルを強調表示します。

ファイルの検索

グローバル検索を使用して、リポジトリ内のファイルを名前で検索します。

ファイルを検索するには、次の手順に従います:

  1. ファイルツリーブラウザーを開きます。次のいずれかの操作を行います:

    • 左上隅で、ファイルツリーブラウザーのアイコン（ file-tree ）を選択します。
    • Shift+Fを押します。

  2. グローバル検索ダイアログを開くには、ファイルの検索を選択するか、Fキーを押します。

  3. 検索するファイル名の一部を入力します。検索結果リストには、一致するファイルとその親ディレクトリが表示されます。

  4. 矢印キーを選択または使用して、Enterキーを押してファイルに移動します。

検索に一致するファイルがない場合、結果が見つかりませんでしたと表示されます。

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

ファイルツリーブラウザーは、これらのキーボードショートカットをサポートしています:

ショートカットアクション
Shift+Fファイルツリーブラウザーの表示と非表示を切り替えます。
Fグローバル検索ダイアログを開きます。

利用可能なキーボードショートカットの完全なリストについては、GitLabキーボードショートカットを参照してください。

ツリーナビゲーション

ファイルツリーブラウザーは、キーボードナビゲーション用にW3C ARIAツリービューパターンを実装しています:

キー機能
Enterまたはスペースフォーカスされたファイルまたはディレクトリを選択します。
↓ディレクトリを開閉せずに、次のファイルまたはディレクトリにフォーカスを移動します。最後の項目をフォーカスしている場合、何も実行しません。
↑ディレクトリを開閉せずに、前のファイルまたはディレクトリにフォーカスを移動します。フォーカスが最初の項目にある場合、何も実行しません。
→閉じられたディレクトリにフォーカスしている場合は、それを開きます。開いているディレクトリをフォーカスしている場合は、フォーカスを内部の最初の項目に移動します。ファイルをフォーカスしている場合は、何も実行しません。
←開いているディレクトリをフォーカスしている場合は、それを閉じます。ファイルまたはネストされた項目をフォーカスしている場合は、その親ディレクトリにフォーカスを移動します。閉じられたルートディレクトリをフォーカスしている場合は、何も実行しません。
Home 1ディレクトリを開閉せずに、最初のファイルまたはディレクトリにフォーカスを移動します。
End 1閉じられたディレクトリを展開せずに、最後のファイルまたはディレクトリにフォーカスを移動します。
a-z、A-Z入力された文字で始まる名前の次のファイルまたはディレクトリにフォーカスを移動します。一致するものが見つからない場合、検索は最初の項目にラップされます。閉じられたディレクトリ内の項目は無視されます。
*（アスタリスク）フォーカスされている項目と同じレベルで、すべての閉じられたディレクトリを展開します。フォーカスは移動しません。

脚注:

  1. HomeキーとEndキーは、一部のキーボードでは使用できない場合があります。