Leader Key

前章でキーマップをやったので、この章ではLeaderキーを設定しておきましょう。

nvim_set_var

突然ですが、ここでニューヒーローをお迎えします❗その名もnvim_set_var❗😆

nvim_set_var({name}, {value})       nvim_set_var()
  Sets a global (g:) variable.

  グローバル(g:)変数を設定する。

  Parameters:
    • {name}   Variable name
    • {value}  Variable value

すごくシンプル❗かぁっくいー❤️

章のタイトルを飾れるだけの力があるのに、なんか無理やりの登場となってしまいました😅

...ただ、この後も出番はかなり限られてくると思われます。

能力の高さゆえ、守備範囲が広大すぎて地球だけに居られない Captain Marvel ¹みたいですね❗

vim.api.nvim_set_var('loaded_python3_provider', 0)

mapleader

                  <Leader> mapleader
To define a mapping which uses the "g:mapleader" variable, the special string
"<Leader>" can be used.  It is replaced with the string value of
"g:mapleader".  If "g:mapleader" is not set or empty, a backslash is used
instead.

変数 "g:mapleader "を使用するマッピングを定義すると、"<Leader>"という特殊な文字列を使用することができる。
これは "g:mapleader "の文字列値と置き換えられる。

g:mapleader "が設定されていない場合や空の場合は、代わりにバックスラッシュが使われる。

Vim scriptの書き方だと思われますが、g:というのがglobalで、mapleaderが変数名ですね 🤔

これはなんかもうnvim_set_varが強すぎるので楽勝です❤️

vim.api.nvim_set_var('mapleader', '\\')

上の例はデフォルトと同じ\になっていますが、ここを好きなキーに変えることができます。

Example

WezTermの時にも挙げましたが、メジャーなのは以下に示すこの辺でしょうか😌

配列は勿論、形状とかも含めて、使用するキーボードに依るので一概には言えないんですが、 「変えた方がいいよー」って人もいるし、「別に変えてないよー」って人もいます。

つまり自由ってことです❗

Space

vim.api.nvim_set_var('mapleader', ' ')

スペースを指定しています。。 :mapではないからっていう理屈だと思うんだけど<Space>と指定してもうまくいかなかったはず。

, (comma)

vim.api.nvim_set_var('mapleader', ',')

メジャーなんだけど、,はNeovimがデフォルトで機能を割り当てていることに注意❗

Two Characters

vim.api.nvim_set_var('mapleader', 'map')

2文字以上を入れても平気みたいなので、何か可能性があるような、いや無いような...🤔

echo

leaderキーの確認はコマンドからできます。

:echo mapleader

設定前に実行するとエラーが出てしまいますが、特に害はありません。

maplocalleader

NeovimにはLocal Leaderというものもあります。

                    <LocalLeader> maplocalleader

<LocalLeader> is just like <Leader>, except that it uses "maplocalleader"
instead of "mapleader".  <LocalLeader> is to be used for mappings which are
local to a buffer.

 <LocalLeader> は <Leader> と同じであるが、"mapleader" の代わりに "maplocalleader" を使用する点が異なる。
 <LocalLeader> は、バッファにローカルに存在するマッピングに使用される。

In a global plugin <Leader> should be used and in a filetype plugin
<LocalLeader>.  "mapleader" and "maplocalleader" can be equal.  Although, if
you make them different, there is a smaller chance of mappings from global
plugins to clash with mappings for filetype plugins.  For example, you could
keep "mapleader" at the default backslash, and set "maplocalleader" to an
underscore.

global プラグインでは <Leader> を、filetype プラグインでは <LocalLeader> を使用する。
"mapleader" と "maplocalleade " は同じでも構わないが、
別にしておけばグローバルプラグインのマッピングとファイルタイププラグインのマッピングが衝突する可能性が低くなる。

例えば、"mapleader "をデフォルトのバックスラッシュのままにして、"maplocalleader "をアンダースコアに設定する。

Example

こっちはなんか_がメジャーらしい...🤔

vim.api.nvim_set_var('maplocalleader', '_')

もちろんmapleaderと同じように、好きなキーを割り当てられます。

プラグインを使い出すと爆発的に機能が増えるので、mapleaderとは別のキーを設定しておくのが良いと思います。 (単純に考えて、ショートカットの組み合わせが 2 倍に増えるので。)

ただ、あくまでも必須ではないです。mapleaderと違って、こちらはデフォルトでも設定されていません。

echo

これもやっぱりコマンドから確認ができます。

:echo maplocalleader

これも設定前に実行するとエラーが出てしまいますが、やっぱり害はありません。

Wrap Up