- sandwich and surround and they can be set using the options mentioned below.
- Provides key mapping to add surrounding characters.( visually select then press
s<char>
or presssa{motion}{char}
) - Provides key mapping to replace surrounding characters.(
sr<from><to>
) - Provides key mapping to delete surrounding characters.(
sd<char>
) ss
repeats last surround command.
- Provides key mapping to add surrounding characters.( visually select then press
s<char>
or pressys{motion}{char}
) - Provides key mapping to replace surrounding characters.(
cs<from><to>
) - Provides key mapping to delete surrounding characters.(
ds<char>
)
<c-s><char>
will insert both pairs in insert mode.<c-s><char><space>
will insert both pairs in insert mode with surrounding whitespace.<c-s><char><c-s>
will insert both pairs on newlines insert mode.
- Cycle surrounding quotes type. (
stq
) - Cycle surrounding brackets type. (
stb
) - Use
<char> == f
for adding, replacing, deleting functions.
- vim-plug:
Plug 'ur4ltz/surround.nvim'
and Put this somewhere in your init.vim:lua require"surround".setup{}
- minPlug:
MinPlug ur4ltz/surround.nvim
and Put this somewhere in your init.vim:lua require"surround".setup{}
- Packer.nvim
use {
"ur4ltz/surround.nvim",
config = function()
require"surround".setup {mappings_style = "sandwich"}
end
}
OR
use {
"ur4ltz/surround.nvim",
config = function()
require"surround".setup {mappings_style = "surround"}
end
}
prefix
: prefix for sandwich mode.(default: s)
pairs
: dictionary or lua table of form{ nestable: {{},...}, linear: {{},....} }
where linear is an array of arrays which contain non-nestable pairs of surrounding characters first opening and second closing like ", ' and nestable is an array of arrays which contain nestable pairs of surrounding characters like (, {, [. The key to each pair can be used as an alias instead of either value. For single-character pairs, this alias is optional and you can just use either value. For pairs that use multiple characters per bracket, an alias is required. You can for example setpairs = { linear = { Q = {'"""','"""'} } }
to use Q to add triple double quotes around selected text. The key "f" is used to add/replace functions, configuring it for a pair will override that functionality.- Aliases must be a single letter.
- Aliases are case-sensitive.
- Aliases must be unique across the entire
pairs
table. - When adding your own pairs, you do not need to specify the defaults. Your own values will be added to the default table and overwrite aliases when necessary.
- Defaults:
{
nestable = {
b = { "(", ")" },
s = { "[", "]" },
B = { "{", "}" },
a = { "<", ">" }
},
linear = {
q = { "'", "'" },
t = { "`", "`" },
d = { '"', '"' }
},
}
context_offset
: number of lines to look for above and below the current line while searching for nestable pairs.(default: 100)
prompt
: whether to print a prompt in the command window asking for input.(default: true)
load_autogroups
: whether to load inbuilt autogroups or not.(default: false)
mappings_style
: "surround" or "sandwich"(default: sandwich)
load_keymaps
: whether to load inbuilt keymaps or not.(default: true)
quotes
: an array of items to be considered as quotes while cycling through them.(default: ["'", '"'])
brackets
: an array of items to be considered as brackets while cycling through them.(default: ["(", "{", "["])
map_insert_mode
: whether to load insert mode mappings or not.(default: true)
space_on_closing_char
: if the closing char should add surround space rather than the opening char.(default: false)
space_on_alias
: if the alias should add surround space.(default: false)
require"surround".setup {
context_offset = 100,
load_autogroups = false,
mappings_style = "sandwich",
map_insert_mode = true,
quotes = {"'", '"'},
brackets = {"(", '{', '['},
space_on_closing_char = false,
pairs = {
nestable = { b = { "(", ")" }, s = { "[", "]" }, B = { "{", "}" }, a = { "<", ">" } },
linear = { q = { "'", "'" }, t = { "`", "`" }, d = { '"', '"' }
},
prefix = "s"
}
- Only supports neovim and always will because it's written in lua which is neovim exclusive.
Doesn't support python docstrings and html tags yet.Either can be added to thepairs
table with an alias as shortcut. (No dynamic tags yet, though. You need to add the tags you want beforehand.)- No vim docs(idk how to make them. Need help)
- Support for repeating actions with
.
requires tpope's vim-repeat.
You are more than welcome to submit PR for a feature you would like to see or bug fixes.