Better Vim uses the Space
key as the default leader. If you want to change it, you can use the better-vim.lua
file.
To change your leader from Space
to ,
you can update your better-vim.lua
to something like:
There are two ways to create your own custom mappings:
lua
and hooks.after_setup
hook in better-vim.lua
.To create your own mappings using the whichkey plugin you’ll use the better-vim.lua
module. Let’s see how to create a mapping to open the file explorer using ctrl + b
:
We can split the mapping creation into 3 parts:
4
we define the combination of keys that we want to use5
we set the command that we want to execute6
we set a description for this mapping📢 Since we’re using whichkey.nvim to create custom mappings, you may want to check its official documentation before creating your own mappings.
You can also create your own mappings by mode. This is important if you have the same shortcuts, but want different commands for different modes:
You can use i
(for insert
mode), n
(for normal
mode), v
(for visual
and select
modes) or x
(for only visual
mode). The options are the same as
used in mappings.custom
.
You can create custom mappings to change tabs. The default mapping is alt/option
+ tab number.
To customize it, just pass a function to the tabs
key inside mappings
table.
The function receives the tab
number. That way you just concatenate the tab number with your custom keys:
The example above will create the mappings:
Now, you can use <leader>h1
to go to tab 1, instead of alt
+ 1
.
To create custom mappings using lua
you can use the hooks.after_setup
entry in better-vim.lua
file, following this tutorial
from the Neovim official documentation.
You can customize your mappings for autocomplete (nvim-cmp
) using lua
, just use the cmp
entry in your configuration.
Check out the example below with defaults:
The before_default_sources
and after_default_sources
options can be used to load
nvim-cmp
plugins before and after the default sources that is already installed with Better Vim.
If you want to know more about nvim-cmp
sources, check out the plugin documentation.