Ex コマンド

@replit/codemirror-vim の Ex コマンドラインモードのリファレンスとカスタムコマンドの定義方法。

Ex コマンド

Ex コマンドは Normal モードで : を押すことで入力します。エディターの下部にコマンドラインプロンプトが表示され、コマンドを入力して Enter で実行します。

組み込み Ex コマンド

ファイルとバッファのコマンド

キーマッピングコマンド

Set コマンド

テキスト操作コマンド

置換フラグ

置換の例

:s/foo/bar/          substitute first 'foo' with 'bar' on current line
:s/foo/bar/g         substitute all 'foo' with 'bar' on current line
:%s/foo/bar/g        substitute all 'foo' with 'bar' in entire buffer
:%s/foo/bar/gi       case-insensitive substitute in entire buffer
:5,10s/foo/bar/g     substitute in lines 5 through 10

global コマンドの例

:g/TODO/d            delete all lines containing 'TODO'
:g/^$/d              delete all blank lines
:g/pattern/normal dd delete lines matching pattern using normal mode command

情報コマンド

カスタム Ex コマンドの定義

Vim.defineEx() を使って Ex コマンドのハンドラーを登録します。これにより :w、:q などのコマンドをアプリケーション内で機能させることができます。

import { Vim } from "@replit/codemirror-vim";

Vim.defineEx() のシグネチャ

Vim.defineEx(name: string, prefix: string, handler: (cm: any, params: any) => void): void

• name — 完全なコマンド名（例: "write"）
• prefix — 短縮エイリアス（例: "w"）
• handler — 実行する関数。CodeMirror アダプターインスタンスとパラメータオブジェクトを受け取ります。

（書き込み/保存）の実装

Vim.defineEx("write", "w", function (cm, params) {
  // Your save logic here
  const content = cm.getValue();
  saveToServer(content);
});

（終了）の実装

Vim.defineEx("quit", "q", function (cm, params) {
  // Your close/quit logic here
  closeEditor();
});

（書き込みして終了）の実装

Vim.defineEx("wquit", "wq", function (cm, params) {
  const content = cm.getValue();
  saveToServer(content).then(() => {
    closeEditor();
  });
});

引数を受け取るカスタムコマンド

params オブジェクトからコマンドライン引数にアクセスできます。

Vim.defineEx("theme", "theme", function (cm, params) {
  const themeName = params.args?.[0];
  if (themeName) {
    applyTheme(themeName);
  }
});

これにより、Vim コマンドラインから :theme dark や :theme light を実行できます。

範囲を受け取るカスタムコマンド

行範囲を操作する Ex コマンドは、params で範囲情報を受け取ります。

Vim.defineEx("upper", "upper", function (cm, params) {
  const { line: start } = params.line ?? { line: 0 };
  const { line: end } = params.lineEnd ?? { line: cm.lineCount() - 1 };
  // Operate on lines start through end
});