WZ Keymap

English

WZ Keymap recreates some of WZ Editor's efficient keyboard operations and provides a fast keyboard-driven workflow.

This is an unofficial extension. It is not affiliated with the developers or distributors of WZ Editor.

It uses less frequently used function keys to reduce common operations to a single keystroke.

Tired of moving your little finger to Ctrl for Ctrl+C, Ctrl+V, Ctrl+X, and similar operations?

Key bindings

Key	Operation
`F5`	Capture a keyword and add the next match to the selection
`Shift+F5`	Paste the keyword captured with F5
`F6`	Open the editor Find control (same as Ctrl+F)
`F7`	Open the editor Replace control (same as Ctrl+H)
`F8`	Cut to the copy stack; also copy to the OS clipboard when integration is enabled
`Shift+F8`	Copy to the copy stack; also copy to the OS clipboard when integration is enabled
`F9`	Paste and consume the preferred source; external clipboard text takes priority when integration is enabled
`Shift+F9`	Paste and retain the preferred source; external clipboard text takes priority when integration is enabled
`F10`	Toggle WZ-style selection mode

The F5 keyword buffer and the F8 / F9 copy stack are completely separate storage areas.

Integrated terminal

When the integrated terminal has focus, both F8 and Shift+F8 copy the selected terminal text to the copy stack without deleting it. When OS clipboard integration is enabled, the same text is also copied to the OS clipboard. If no terminal text is selected, a status-bar message is shown.

F9 sends the preferred paste item to the active terminal and consumes it when applicable. Shift+F9 sends the item without consuming it. When OS clipboard integration is enabled and another application has placed different text on the clipboard, that external text takes priority over existing stack items. Terminal selections retain their line breaks, so pasting an item that ends with a line break may immediately execute it as a shell command.

F5 / Shift+F5 — Keyword operations

F5 — Capture a keyword and select the next match

Pressing F5 captures the current selection, or the word at the cursor when nothing is selected, in the dedicated F5 buffer. Repeated presses add the next literal occurrence to the selections.

Shift+F5 — Paste the captured keyword

Pressing Shift+F5 inserts the keyword most recently captured with F5 at the current position.

If the selection created by F5 is still active, it is cleared and the keyword is inserted immediately after it. Otherwise, an existing selection is replaced. With multiple cursors, the same keyword is inserted at every cursor.

F6 / F7 — Find / Replace

F6 and F7 use the standard VS Code Find/Replace behavior. Because F5 leaves the captured keyword selected without changing the internal Find state, VS Code can seed the Find input from that selection.

F8 / Shift+F8 — Copy and cut

These bindings follow the WZ Editor key layout.

F8: Push the selected range onto the copy stack and cut it. With no selection, cut the current line.
Shift+F8: Push the selected range onto the copy stack and copy it. With no selection, copy the current line.

With multiple selected ranges, F8 stores one stack item per range. The ranges are cut bottom-to-top so that F9 and Shift+F9 can paste matching items into cursors top-to-bottom. F9 consumes those items; Shift+F9 retains them. If the extra cursors are dismissed first, each F9 pastes and consumes the next item.

Text is stored in the extension's own stack. OS clipboard integration is enabled by default and can be disabled with wzOperation.copyStack.osClipboardIntegration.

F8 with an active IME and EditContext

To make F8 cutting work correctly while an IME is active, this extension contributes a recommended default value of false for VS Code's editor.editContext setting. This default is supplied through configurationDefaults; it does not modify user or workspace settings. It applies only while the extension is enabled and only when the user has not explicitly specified a value.

"editor.editContext": false

If the user explicitly specifies "editor.editContext": true in a settings file, that value takes precedence. In this state, the IME processes F8 while text is selected, so this extension's F8 cut command might not run.

When the effective value of editor.editContext is true, the extension displays a notification with an Open Settings button so that the problem can be reviewed. The notification is displayed at most twice for each extension version.

To test the notification again, run WZ Keymap: Reset EditContext Notification State from the Command Palette. This removes only this extension's EditContext notification state and checks whether to show the notification again the next time VS Code starts.

To use this extension's F8 cut operation while an IME is active, remove the explicit true setting for editor.editContext or change it to false.

F9 / Shift+F9 — Paste from the stack

F9: Paste the top stack item and remove it from the stack.
Shift+F9: Paste the top stack item and keep it on the stack.

For example, after copying AAA, BBB, and CCC in that order, CCC is at the top of the stack.

Pressing Shift+F9 repeatedly continues to paste CCC. Pressing F9 pastes and removes CCC, so the next F9 pastes BBB.

When OS clipboard integration is enabled and another application copies text that differs from the item most recently mirrored by this extension, both F9 and Shift+F9 prioritize that external clipboard text over existing stack items. They also use the OS clipboard when the stack is empty. After a successful paste, F9 clears clipboard-sourced text while Shift+F9 retains it. Neither operation adds clipboard content to the copy stack. When integration is disabled, only the copy stack is used.

When F9 consumes a stack item that the extension most recently mirrored to the operating system clipboard, that clipboard text is also cleared if it is still unchanged.

Run WZ Keymap: Paste from Copy Stack List from the Command Palette to paste a selected item without removing it. Use WZ Keymap: Paste and Consume from Copy Stack List to remove the selected item only after a successful paste. Both lists are displayed newest-first. WZ Keymap: Clear Copy Stack removes all items and resets its used capacity to zero.

F10 — Selection mode

Press F10 to start a selection at each active cursor. While selection mode is active, the arrow keys, Home/End, PageUp/PageDown, Ctrl+Left/Right, and Ctrl+Home/End extend the selections as if Shift were locked.

Press F10 or Escape to leave selection mode, clear the selections, and keep each cursor at its active end. F8 and Shift+F8 perform their normal cut/copy operation and then leave the mode. Switching editors also leaves the mode automatically. Completion-list navigation keeps its normal behavior while suggestions are visible.

Separate F5 buffer and copy stack

The F5 / Shift+F5 keyword buffer and the F8 / Shift+F8 / F9 / Shift+F9 copy stack are completely independent.

A keyword captured with F5 never enters the F8/F9 history, and F8/F9 copy contents never overwrite the F5 keyword.

The F5 buffer does not use the operating system clipboard. When OS clipboard integration is enabled, F8 and Shift+F8 mirror copied text to it for interoperability with other applications.

Copy-stack capacity and lifetime

By default, the copy stack retains up to 64 MiB of text in total, calculated as UTF-16. The default limit for one item is 16 MiB.

These limits can be changed in VS Code Settings. The setting names are localized to the current VS Code display language:

Maximum Total Copy-Stack Size (wzOperation.copyStack.maxTotalSizeMiB)
Maximum Copy-Stack Item Size (wzOperation.copyStack.maxItemSizeMiB)
OS Clipboard Integration (wzOperation.copyStack.osClipboardIntegration, default: true)

If the per-item limit is greater than the total limit, the total limit becomes the effective per-item limit.

When the total limit is exceeded, the oldest items are discarded automatically. If selected text exceeds the per-item limit, neither copying nor cutting is performed.

For a normal multiple-cursor paste, the extension checks the logical data size by multiplying the item size by the number of cursors. For an F8 multi-cut batch, it checks the sum of the matching items instead. A paste is not performed if one operation would exceed the configured maximum total copy-stack size.

The stack is currently volatile and kept only in memory. Both the F5 buffer and copy stack are cleared when the VS Code Extension Host restarts.

After a successful F8, Shift+F8, F9, or Shift+F9 operation, the status bar briefly shows the current item count and used capacity in KiB with two decimal places, for example WZ Keymap: Stack 5 items / 18.25 KiB.

Existing keybindings.json entries

If the same keys are already assigned in your user settings, those definitions may take precedence over this extension.

If you previously configured the F5, F8, or F9 key families manually, comment out or remove those entries as needed.

Example:

{
  "key": "f5",
  "command": "editor.action.addSelectionToNextFindMatch",
  "when": "editorTextFocus"
}

Compatibility

Visual Studio Code 1.90.0 or later
Windows / macOS / Linux

Display languages

Command names, setting names and descriptions, and status-bar messages follow the VS Code display language.

English
Japanese

Other display languages fall back to English.

Command Palette

To change the keybindings, assign any keys to the following commands:

WZ Keymap: Toggle Selection Mode
WZ Keymap: Capture Keyword and Select Next Match
WZ Keymap: Paste Captured Keyword
WZ Keymap: Cut Selection to Copy Stack
WZ Keymap: Copy Selection to Copy Stack
WZ Keymap: Paste and Consume from Copy Stack
WZ Keymap: Paste from Copy Stack
WZ Keymap: Paste from Copy Stack List
WZ Keymap: Paste and Consume from Copy Stack List
WZ Keymap: Clear Copy Stack
WZ Keymap: Reset EditContext Notification State

日本語

WZ Keymap は、WZ Editorの効率的なキーボード操作の一部を再現し、軽快なキー操作を実現します。

非公式拡張です。 本拡張は WZ Editor の開発元・販売元とは関係ありません。

使用頻度の低いファンクションキーを活用し、頻繁に使用する操作をワンストロークで簡略化します。

CTRL+C, CTRL+V, CTRL+X etc.. 小指をCTRLに移動させる操作に嫌気が差していませんか？

キー操作

キー	操作
`F5`	キーワード取得 + 次の一致も選択
`Shift+F5`	F5で取得したキーワードを貼り付け
`F6`	エディターの検索窓を開く（Ctrl+Fと同等）
`F7`	エディターの置換窓を開く（Ctrl+Hと同等）
`F8`	コピースタックへ切り取り。連携ONならOSクリップボードにもコピー
`Shift+F8`	コピースタックへコピー。連携ONならOSクリップボードにもコピー
`F9`	優先対象を貼り付けて消費。連携ONなら他のアプリのクリップボードを優先
`Shift+F9`	優先対象を貼り付けて保持。連携ONなら他のアプリのクリップボードを優先
`F10`	WZ形式の範囲選択モードを切り替え

F5 系のキーワードバッファと F8 / F9 系のコピースタックは 完全に別領域 です。

統合ターミナル

統合ターミナルにフォーカスがある場合、F8とShift+F8はどちらも選択文字列を削除せずにコピースタックへ保存します。OSクリップボード連携が有効なら、同じ文字列をOSクリップボードにもコピーします。文字列が選択されていない場合は、ステータスバーへ案内を表示します。

F9は優先対象となる項目をアクティブなターミナルへ入力し、該当する場合は消費します。Shift+F9は項目を消費せずに入力します。OSクリップボード連携が有効で、他のアプリが異なる文字列をクリップボードへコピーした場合は、その外部文字列を既存のスタック項目より優先します。ターミナルの選択文字列に含まれる改行はそのまま保持されるため、行末の改行を含む項目を貼り付けると、シェルのコマンドとして直ちに実行される場合があります。

F5 / Shift+F5 — キーワード操作

F5 — キーワード取得 + 次の一致も選択

F5 を押すと、現在の選択範囲を、未選択の場合はカーソル位置の単語を F5専用バッファ へ保存します。繰り返し押すと、次の文字列一致を選択へ追加します。

Shift+F5 — 取得したキーワードを貼り付け

Shift+F5 を押すと、直前の F5 で取得したキーワードを現在位置へ挿入します。

F5 による選択がそのまま残っている場合は、選択を解除してキーワードの直後へ挿入します。それ以外の選択範囲がある場合はその範囲を置換し、複数カーソルがある場合は各カーソルへ同じキーワードを挿入します。

F6 / F7 — 検索 / 置換

F6とF7はVS Code標準の検索・置換動作を使用します。F5は内部の検索状態を変更せず、取得したキーワードを選択状態にするため、VS Codeがその選択範囲から検索欄へキーワードを設定できます。

F8 / Shift+F8 — コピー・切り取り

WZ Editorのキー配置に合わせています。

F8: 選択開始位置から選択終了位置までをコピースタックへ積んで 切り取り。未選択時は現在行を1行切り取り
Shift+F8: 選択範囲をコピースタックへ積んで コピー。未選択時は現在行を1行コピー

複数の選択範囲がある場合、F8は範囲ごとに1項目として保存します。下の範囲から順に切り取り、F9とShift+F9では上のカーソルから対応する項目を貼り付けます。F9は項目を消費し、Shift+F9は保持します。先に複数カーソルを解除した場合は、F9を押すたびに次の項目を貼り付けて消費します。

本拡張専用のテキストスタックへ保存します。OSクリップボード連携は既定でONで、wzOperation.copyStack.osClipboardIntegrationからOFFにできます。

IME使用中のF8とEditContext

本拡張は、F8による切り取りをIME使用中も正しく動作させるため、VS Codeのeditor.editContextへfalseの推奨デフォルトを提供します。このデフォルトはconfigurationDefaultsによるもので、ユーザー設定やワークスペース設定を書き換えません。本拡張が有効な間だけ、利用者が値を明示していない場合に適用されます。

"editor.editContext": false

利用者が設定ファイルなどで"editor.editContext": trueを明示している場合は、その設定が優先されます。この状態ではIMEが選択中のF8を処理するため、本拡張のF8切り取りコマンドが実行されないことがあります。

editor.editContextの実効値がtrueの場合は、問題を確認できるよう「設定を開く」ボタン付きの通知を行います。拡張機能の各バージョンにつき最大2回通知します。

通知動作を再確認する場合は、コマンドパレットからWZ Keymap: EditContext通知状態をリセットを実行してください。本拡張のEditContext通知状態だけを削除し、次回のVS Code起動時に通知を再判定します。

IME使用中も本拡張のF8切り取りを利用する場合は、editor.editContextの明示的なtrue設定を削除するか、falseへ変更してください。

F9 / Shift+F9 — スタック貼り付け

F9: スタック先頭を貼り付け、その項目をスタックから消費
Shift+F9: スタック先頭を貼り付け、その項目をスタックに残す

たとえば AAA → BBB → CCC の順にコピーした場合、スタック先頭は CCC です。

Shift+F9 を何度押しても CCC が貼り付けられます。F9 を押すと CCC を貼り付けたあとスタックから消費されるため、次の F9 では BBB が貼り付けられます。

OSクリップボード連携がONで、他のアプリが本拡張から最後に同期した項目とは異なる文字列をコピーした場合、F9とShift+F9は既存のコピースタックよりその外部クリップボードを優先します。スタックが空の場合もOSクリップボードを使用します。貼り付け成功後、F9はクリップボード由来の文字列を消去し、Shift+F9は保持します。どちらもクリップボードの内容をコピースタックへ追加しません。連携がOFFの場合はコピースタックだけを使用します。

F9で消費するスタック項目が、本拡張から最後にOSクリップボードへ同期した項目であり、その内容が変わっていない場合は、OSクリップボード側の同じテキストも消去します。

コマンドパレットからWZ Keymap: コピースタック一覧から貼り付けを実行すると、選択項目を削除せずに貼り付けます。WZ Keymap: コピースタック一覧から貼り付けて消費では、貼り付け成功後に選択項目を削除します。どちらもスタック項目を新しい順に一覧表示します。WZ Keymap: コピースタックをクリアでは全履歴を削除し、使用容量を0へ戻します。

F10 — 範囲選択モード

F10を押すと、各カーソルの現在位置を起点に範囲選択モードを開始します。モード中は、矢印キー、Home/End、PageUp/PageDown、Ctrl+Left/Right、Ctrl+Home/Endが、Shiftを固定したように選択範囲を拡張します。

もう一度F10またはEscapeを押すと、選択範囲を解除して各カーソルをactive側の位置に残します。F8とShift+F8は通常どおり切り取り・コピーを実行してから範囲選択モードを終了します。エディターを切り替えた場合も自動的に終了します。補完候補の表示中は候補一覧の移動キー操作を優先します。

F5バッファとコピースタックは別領域

F5 / Shift+F5 のキーワードバッファと、F8 / Shift+F8 / F9 / Shift+F9 のコピースタックは 完全に独立 しています。

F5で取得したキーワードがF8/F9の履歴へ混ざることはなく、F8/F9のコピー内容がF5キーワードを上書きすることもありません。

F5専用バッファはOSクリップボードを使用しません。OSクリップボード連携がONの場合、F8とShift+F8はコピー内容をOSクリップボードにも反映します。

コピースタックの容量と保存期間

コピースタックはテキスト本体をUTF-16換算で、既定で合計最大 64 MiB まで保持します。1項目の既定の上限は 16 MiB です。

上限はVS Codeの設定画面から変更できます。設定項目名はVS Codeの表示言語に合わせて切り替わります。

コピースタック全体の最大サイズ (wzOperation.copyStack.maxTotalSizeMiB)
コピースタック1項目の最大サイズ (wzOperation.copyStack.maxItemSizeMiB)
OSクリップボード連携 (wzOperation.copyStack.osClipboardIntegration, 既定値: true)

1項目の上限を合計上限より大きく設定した場合は、合計上限が実効上限になります。

合計上限を超えた場合は、最も古い項目から自動的に破棄します。1項目の上限を超える選択内容は、コピーも切り取りも行いません。

通常の複数カーソル貼り付けでは、貼り付ける項目の容量とカーソル数を掛けた論理データ量を検査します。F8の複数切り取りバッチでは、対応する各項目の合計容量を検査します。1回の貼り付けが設定された コピースタック全体の最大サイズ を超える場合は実行しません。

現時点ではメモリ上に保持する揮発性スタックです。 F5専用バッファとコピースタックはいずれも、VS CodeのExtension Hostを再起動すると消去されます。

F8、Shift+F8、F9、Shift+F9の操作に成功すると、現在の項目数と使用容量をKiB単位・小数点以下2桁でステータスバーへ一時表示します（例：WZ Keymap: スタック 5項目 / 18.25 KiB）。

既存の keybindings.json について

同じキーにユーザー定義がある場合は、その定義が本拡張より優先されることがあります。

以前 F5 / F8 / F9 系を手動設定していた場合は、必要に応じてコメントアウトまたは削除してください。

例:

{
  "key": "f5",
  "command": "editor.action.addSelectionToNextFindMatch",
  "when": "editorTextFocus"
}

対応環境

Visual Studio Code 1.90.0 以降
Windows / macOS / Linux

表示言語

コマンド名、設定項目名と説明、ステータスバーメッセージは、VS Codeの表示言語に合わせて切り替わります。

日本語
英語

上記以外の表示言語では英語を使用します。

コマンドパレット

キーバインドを変更したい場合は、以下のコマンドを任意のキーへ割り当てます。

WZ Keymap: 範囲選択モード切り替え
WZ Keymap: キーワード取得 + 次の一致も選択
WZ Keymap: 取得したキーワードを貼り付け
WZ Keymap: 単行or選択範囲を切り取りしてコピースタックへ追加
WZ Keymap: 単行or選択範囲をコピースタックへ追加
WZ Keymap: コピースタックから貼り付けて消費
WZ Keymap: コピースタックから貼り付け
WZ Keymap: コピースタック一覧から貼り付け
WZ Keymap: コピースタック一覧から貼り付けて消費
WZ Keymap: コピースタックをクリア
WZ Keymap: EditContext通知状態をリセット

WZ Keymap

kiyoc

WZ Keymap

English

Key bindings

Integrated terminal

F5 / Shift+F5 — Keyword operations

F5 — Capture a keyword and select the next match

Shift+F5 — Paste the captured keyword

F6 / F7 — Find / Replace

F8 / Shift+F8 — Copy and cut

F8 with an active IME and EditContext

F9 / Shift+F9 — Paste from the stack

F10 — Selection mode

Separate F5 buffer and copy stack

Copy-stack capacity and lifetime

Existing keybindings.json entries

Compatibility

Display languages

Command Palette

日本語

キー操作

統合ターミナル

F5 / Shift+F5 — キーワード操作

F5 — キーワード取得 + 次の一致も選択

Shift+F5 — 取得したキーワードを貼り付け

F6 / F7 — 検索 / 置換

F8 / Shift+F8 — コピー・切り取り

IME使用中のF8とEditContext

F9 / Shift+F9 — スタック貼り付け

F10 — 範囲選択モード

F5バッファとコピースタックは別領域

コピースタックの容量と保存期間

既存の keybindings.json について

対応環境

表示言語

コマンドパレット