キーバインド

Zedは、~/.config/zed/keymap.jsonにあるシンプルなJSONファイルで設定できます。

プリセットキーマップ

zedリポジトリのkeymapsフォルダには、プリセットキーマップが多数用意されています。現在のキーマップには、以下が含まれています。

• Atom
• JetBrains
• SublimeText
• TextMate
• VSCode (デフォルト)

これらのキーマップは、settings.jsonファイルのbase_keymap設定で指定できます。また、最初から独自のキーマップを作成したい場合は、この設定に"None"を指定できます。

カスタムキーバインド

カスタムキーバインドへのアクセス

⌘ + K、⌘ + S、コマンドパレット、またはアプリケーションメニューのZed > 設定 > キーバインドを開くからkeymap.jsonを開くことができます。

カスタムキーバインドの追加

キーバインドをカスタマイズするには、コンテキストと設定するバインドのリストを指定します。既存のバインドを再マッピングすると、カスタムバインドが優先され、既存のバインドは上書きされます。

カスタムキーバインドの追加例

[
  {
    "context": "Editor",
    "bindings": {
      "ctrl-w": "editor::SelectLargerSyntaxNode",
      "ctrl-shift-W": "editor::SelectSmallerSyntaxNode",
      "ctrl-c": "editor::Cancel"
    }
  }
]

Zedのdefault.jsonで、さらに多くの例を確認できます。

上書きできないキーバインドがいくつかあります。この問題については現在対応中です。

キーバインド構文

Zedは、単一のキー押下だけでなく、順番に入力されたキーのシーケンスにも対応できます。"bindings"マップ内の各キーは、スペースで区切られたキー押下のシーケンスです。

各キー押下は、修飾子に続いてキーが続くシーケンスです。修飾子は次のとおりです。

• ctrl- コントロールキー

• cmd-、win-、またはsuper- プラットフォーム修飾子（macOSではCommandキー、WindowsではWindowsキー、LinuxではSuperキー）

• alt- altキー（macOSではoptionキー）
• shift- シフトキー
• fn- ファンクションキー

キーは、キーボードが生成する任意の単一Unicodeコードポイント（例：a、0、£、ç）、または任意の命名キー（tab、f1、shift、cmd）です。

いくつかの例

 "bindings": {
   "cmd-k cmd-s": "zed::OpenKeymap", // matches ⌘-k then ⌘-s
   "space e": "editor::Complete", // type space then e
   "ç": "editor::Complete", // matches ⌥-c
   "shift shift": "file_finder::Toggle", // matches pressing and releasing shift twice
 }

shift-修飾子は、大文字バージョンを示すために文字と組み合わせてのみ使用できます。たとえば、shift-gはGの入力に一致します。多くのキーボードではシフトキーを使用して(などの句読点記号を入力しますが、キー押下は修飾されていないとみなされるため、shift-(は一致しません。

alt-修飾子は、多くのレイアウトで異なるキーを生成するために使用できます。たとえば、macOS USキーボードでは、alt-cの組み合わせでçが入力されます。キーマップファイルではどちらにも一致できますが、慣例としてZedではこの組み合わせをalt-cと表記します。

修飾キー単体への入力にも一致させることができます。たとえば、shift shiftを使用して、JetBrainsの検索機能のショートカットを実装できます。この場合、バインドはキー押下ではなくキー解放時に発生します。

キーのリマッピング

よくある要望として、あるキーシーケンスを別のキーシーケンスにマッピングしたいというものがあります。Zed 0.124.0以降では、workspace::SendKeystrokesアクションを使用してこれを行うことができます。

[
  {
    "bindings": {
      "alt-down": ["workspace::SendKeystrokes", "down down down down"],
      "cmd-alt-c": [
        "workspace::SendKeystrokes",
        "cmd-shift-p copy relative path enter"
      ],
      "cmd-alt-r": ["workspace::SendKeystrokes", "cmd-p README enter"]
    }
  },
  {
    "context": "Editor && vim_mode == insert",
    "bindings": {
      "j k": ["workspace::SendKeystrokes", "escape"]
    }
  }
]

これにはいくつかの制限があります。特に、

• 非同期操作は、すべてのキーバインドがディスパッチされた後まで実行されません。たとえば、これは、バインドを使用してファイルを開くことができます（cmd-alt-rの例のように）が、さらにキーストロークを送信して新しいビューで解釈させることはできないことを意味します。
• • 非同期処理のその他の例としては、言語サーバーとの通信、バッファの言語の変更、ネットワークにアクセスする処理などがあります。
• 一度にシミュレートできるキーの数には100個の制限があります。これは、バインド内でSendKeystrokesを再度トリガーした場合に、意図しない無限再帰を回避するためです。

SendKeystrokesの引数は、スペースで区切られたキーストロークのリストです（上記と同じ構文を使用）。キーストロークの解析方法により、キー押下として認識されないセグメントは、現在フォーカスされている入力フィールドにそのまま送信されます。

ターミナルへのキー転送

LinuxまたはWindowsを使用している場合、キーの組み合わせをZedではなく組み込みターミナルに転送したい場合があります。

たとえば、Linuxではctrl-nでZedに新しいタブが作成されます。フォーカスされているときにctrl-nを組み込みターミナルに送信するには、キーマップに次の行を追加します。

{
  "context": "Terminal",
  "bindings": {
    "ctrl-n": ["terminal::SendKeystroke", "ctrl-n"]
  }
}

タスクキーバインド

tasks.jsonで定義されたZedタスクを起動するキーにもバインドできます。詳細については、タスクのドキュメントを参照してください。

すべてのキーバインド

グローバル

エディタ

エディタ（フルスクリーンのみ）

エディタ（自動高さのみ）

ペイン

バッファ検索バー

ワークスペース

プロジェクトパネル

プロジェクト検索バー

ターミナル

アシスタントエディタ