mirror of
https://github.com/neovim/neovim.git
synced 2025-10-26 12:27:24 +00:00
133 lines
4.3 KiB
Lua
133 lines
4.3 KiB
Lua
local keymap = {}
|
|
|
|
--- Add a new |mapping|.
|
|
--- Examples:
|
|
--- <pre>lua
|
|
--- -- Can add mapping to Lua functions
|
|
--- vim.keymap.set('n', 'lhs', function() print("real lua function") end)
|
|
---
|
|
--- -- Can use it to map multiple modes
|
|
--- vim.keymap.set({'n', 'v'}, '<leader>lr', vim.lsp.buf.references, { buffer=true })
|
|
---
|
|
--- -- Can add mapping for specific buffer
|
|
--- vim.keymap.set('n', '<leader>w', "<cmd>w<cr>", { silent = true, buffer = 5 })
|
|
---
|
|
--- -- Expr mappings
|
|
--- vim.keymap.set('i', '<Tab>', function()
|
|
--- return vim.fn.pumvisible() == 1 and "<C-n>" or "<Tab>"
|
|
--- end, { expr = true })
|
|
--- -- <Plug> mappings
|
|
--- vim.keymap.set('n', '[%%', '<Plug>(MatchitNormalMultiBackward)')
|
|
--- </pre>
|
|
---
|
|
--- Note that in a mapping like:
|
|
--- <pre>lua
|
|
--- vim.keymap.set('n', 'asdf', require('jkl').my_fun)
|
|
--- </pre>
|
|
---
|
|
--- the ``require('jkl')`` gets evaluated during this call in order to access the function.
|
|
--- If you want to avoid this cost at startup you can wrap it in a function, for example:
|
|
--- <pre>lua
|
|
--- vim.keymap.set('n', 'asdf', function() return require('jkl').my_fun() end)
|
|
--- </pre>
|
|
---
|
|
---@param mode string|table Same mode short names as |nvim_set_keymap()|.
|
|
--- Can also be list of modes to create mapping on multiple modes.
|
|
---@param lhs string Left-hand side |{lhs}| of the mapping.
|
|
---@param rhs string|function Right-hand side |{rhs}| of the mapping. Can also be a Lua function.
|
|
--
|
|
---@param opts table|nil A table of |:map-arguments|.
|
|
--- + Accepts options accepted by the {opts} parameter in |nvim_set_keymap()|,
|
|
--- with the following notable differences:
|
|
--- - replace_keycodes: Defaults to `true` if "expr" is `true`.
|
|
--- - noremap: Always overridden with the inverse of "remap" (see below).
|
|
--- + In addition to those options, the table accepts the following keys:
|
|
--- - buffer: (number or boolean) Add a mapping to the given buffer.
|
|
--- When `0` or `true`, use the current buffer.
|
|
--- - remap: (boolean) Make the mapping recursive.
|
|
--- This is the inverse of the "noremap" option from |nvim_set_keymap()|.
|
|
--- Defaults to `false`.
|
|
---@see |nvim_set_keymap()|
|
|
function keymap.set(mode, lhs, rhs, opts)
|
|
vim.validate({
|
|
mode = { mode, { 's', 't' } },
|
|
lhs = { lhs, 's' },
|
|
rhs = { rhs, { 's', 'f' } },
|
|
opts = { opts, 't', true },
|
|
})
|
|
|
|
opts = vim.deepcopy(opts) or {}
|
|
mode = type(mode) == 'string' and { mode } or mode
|
|
|
|
if opts.expr and opts.replace_keycodes ~= false then
|
|
opts.replace_keycodes = true
|
|
end
|
|
|
|
if opts.remap == nil then
|
|
-- default remap value is false
|
|
opts.noremap = true
|
|
else
|
|
-- remaps behavior is opposite of noremap option.
|
|
opts.noremap = not opts.remap
|
|
opts.remap = nil
|
|
end
|
|
|
|
if type(rhs) == 'function' then
|
|
opts.callback = rhs
|
|
rhs = ''
|
|
end
|
|
|
|
if opts.buffer then
|
|
local bufnr = opts.buffer == true and 0 or opts.buffer
|
|
opts.buffer = nil
|
|
for _, m in ipairs(mode) do
|
|
vim.api.nvim_buf_set_keymap(bufnr, m, lhs, rhs, opts)
|
|
end
|
|
else
|
|
opts.buffer = nil
|
|
for _, m in ipairs(mode) do
|
|
vim.api.nvim_set_keymap(m, lhs, rhs, opts)
|
|
end
|
|
end
|
|
end
|
|
|
|
--- Remove an existing mapping.
|
|
--- Examples:
|
|
--- <pre>lua
|
|
--- vim.keymap.del('n', 'lhs')
|
|
---
|
|
--- vim.keymap.del({'n', 'i', 'v'}, '<leader>w', { buffer = 5 })
|
|
--- </pre>
|
|
---@param opts table|nil A table of optional arguments:
|
|
--- - buffer: (number or boolean) Remove a mapping from the given buffer.
|
|
--- When "true" or 0, use the current buffer.
|
|
---@see |vim.keymap.set()|
|
|
---
|
|
function keymap.del(modes, lhs, opts)
|
|
vim.validate({
|
|
mode = { modes, { 's', 't' } },
|
|
lhs = { lhs, 's' },
|
|
opts = { opts, 't', true },
|
|
})
|
|
|
|
opts = opts or {}
|
|
modes = type(modes) == 'string' and { modes } or modes
|
|
|
|
local buffer = false
|
|
if opts.buffer ~= nil then
|
|
buffer = opts.buffer == true and 0 or opts.buffer
|
|
end
|
|
|
|
if buffer == false then
|
|
for _, mode in ipairs(modes) do
|
|
vim.api.nvim_del_keymap(mode, lhs)
|
|
end
|
|
else
|
|
for _, mode in ipairs(modes) do
|
|
vim.api.nvim_buf_del_keymap(buffer, mode, lhs)
|
|
end
|
|
end
|
|
end
|
|
|
|
return keymap
|