nvim-hlslens helps you better glance at matched information, seamlessly jump between matched instances.
hlslens-demo.mp4
- Fully customizable style of virtual text
- Display virtual text dynamicly while cursor is moving
- Clear highlighting and virtual text when cursor is out of range
- Add virtual text for the current matched instance while searching
- Thanks to the cache and asynchronous rendering, it is very fast
- Neovim 0.5 or later
0.6 or later must be required for Windows users
Install nvim-hlslens with Vim-plug:
Plug 'kevinhwang91/nvim-hlslens'
Install nvim-hlslens with Packer.nvim:
use {'kevinhwang91/nvim-hlslens'}
" vimscript
Plug 'kevinhwang91/nvim-hlslens'
noremap <silent> n <Cmd>execute('normal! ' . v:count1 . 'n')<CR>
\<Cmd>lua require('hlslens').start()<CR>
noremap <silent> N <Cmd>execute('normal! ' . v:count1 . 'N')<CR>
\<Cmd>lua require('hlslens').start()<CR>
noremap * *<Cmd>lua require('hlslens').start()<CR>
noremap # #<Cmd>lua require('hlslens').start()<CR>
noremap g* g*<Cmd>lua require('hlslens').start()<CR>
noremap g# g#<Cmd>lua require('hlslens').start()<CR>
" use : instead of <Cmd>
nnoremap <silent> <leader>l :noh<CR>
After using Minimal configuration:
Hlslens will add virtual text at the end of the line if the room is enough for virtual text, otherwise, add a floating window to overlay the statusline to display lens.
You can glance at the result provided by lens while searching when incsearch
is on.
Hlslens also supports <C-g>
and <C-t>
to move to the next and previous match.
- Press
/
or?
to search text,/s
and/e
offsets are supported - Press
n
orN
to jump to the instance matched by last pattern - Press
*
,#
,g*
org#
to search word nearest to the cursor
run ex command :help search-commands for more information.
Hlslens will observe whether nohlsearch
command is accepted.
- Run ex command
nohlsearch
- Map key to
:nohlsearch
, make sure that to use:
instead of<Cmd>
root = {
auto_enable = {
description = [[Enable nvim-hlslens automatically]],
default = true
},
enable_incsearch = {
description = [[When `incsearch` option is on and enable_incsearch is true, add lens
for the current matched instance]],
default = true
},
calm_down = {
description = [[When the cursor is out of the position range of the matched instance
and calm_down is true, clear all lens]],
default = false,
},
nearest_only = {
description = [[Only add lens for the nearest matched instance and ignore others]],
default = false
},
nearest_float_when = {
description = [[When to open the floating window for the nearest lens.
'auto': floating window will be opened if room isn't enough for virtual text;
'always': always use floating window instead of virtual text;
'never': never use floating window for the nearest lens]],
default = 'auto',
},
float_shadow_blend = {
description = [[Winblend of the nearest floating window. `:h winbl` for more details]],
default = 50,
},
virt_priority = {
description = [[Priority of virtual text, set it lower to overlay others.
`:h nvim_buf_set_extmark` for more details]],
default = 100,
},
build_position_cb = {
description = [[A callback function after position list is built,
if `changedtick` or `pattern` is changed, position list will be rebuild and fire this callback.
@param plist (table) {start_pos = {}, end_pos = {}} (1,1)-indexed position
@param bufnr (number) buffer number
@param changedtick (number) `h b:changedtick`
@param pattern (string) search pattern
]],
default = nil
},
override_lens = {
description = [[Hackable function for customizing the lens. If you like hacking, you
should search `override_lens` and inspect the corresponding source code.
There's no guarantee that this function will not be changed in the future. If it is
changed, it will be listed in the CHANGES file.
@param bufnr (number) buffer number
@param splist (table) (1,1)-indexed position
@param nearest (boolean) whether nearest lens
@param idx (number) nearest index in the plist
@param r_idx (number) relative index, negative means before current position,
positive means after
]],
default = nil
},
}
hi default link HlSearchNear IncSearch
hi default link HlSearchLens WildMenu
hi default link HlSearchLensNear IncSearch
hi default link HlSearchFloat IncSearch
- HlSearchLensNear: highlight the nearest virtual text
- HlSearchLens: highlight virtual text except for the nearest one
- HlSearchNear: highlight the nearest matched instance
- HlSearchFloat: highlight the nearest text for the floating window
HlSearchLensToggle
: Toggle nvim-hlslens enable/disableHlSearchLensEnable
: Enable nvim-hlslensHlSearchLensDisable
: Disable nvim-hlslens
-- lua
require('hlslens').setup({
calm_down = true,
nearest_only = true,
nearest_float_when = 'always'
})
hlslens-customize.mp4
-- lua
require('hlslens').setup({
override_lens = function(render, plist, nearest, idx, r_idx)
local sfw = vim.v.searchforward == 1
local indicator, text, chunks
local abs_r_idx = math.abs(r_idx)
if abs_r_idx > 1 then
indicator = ('%d%s'):format(abs_r_idx, sfw ~= (r_idx > 1) and '▲' or '▼')
elseif abs_r_idx == 1 then
indicator = sfw ~= (r_idx == 1) and '▲' or '▼'
else
indicator = ''
end
local lnum, col = unpack(plist[idx])
if nearest then
local cnt = #plist
if indicator ~= '' then
text = ('[%s %d/%d]'):format(indicator, idx, cnt)
else
text = ('[%d/%d]'):format(idx, cnt)
end
chunks = {{' ', 'Ignore'}, {text, 'HlSearchLensNear'}}
else
text = ('[%s %d]'):format(indicator, idx)
chunks = {{' ', 'Ignore'}, {text, 'HlSearchLens'}}
end
render.set_virt(0, lnum - 1, col - 1, chunks, nearest)
end
})
" vimscript
call plug#begin('~/.config/nvim/plugged')
Plug 'kevinhwang91/nvim-hlslens'
" integrate with vim-asterisk
Plug 'haya14busa/vim-asterisk'
map * <Plug>(asterisk-z*)<Cmd>lua require('hlslens').start()<CR>
map # <Plug>(asterisk-z#)<Cmd>lua require('hlslens').start()<CR>
map g* <Plug>(asterisk-gz*)<Cmd>lua require('hlslens').start()<CR>
map g# <Plug>(asterisk-gz#)<Cmd>lua require('hlslens').start()<CR>
" integrate with vim-visual-multi
Plug 'mg979/vim-visual-multi'
aug VMlens
au!
au User visual_multi_start lua require('vmlens').start()
au User visual_multi_exit lua require('vmlens').exit()
aug END
call plug#end()
Add vmlens.lua under your lua path, for instance: ~/.config/nvim/lua/vmlens.lua
-- lua
local M = {}
local hlslens = require('hlslens')
local config
local lens_backup
local override_lens = function(render, plist, nearest, idx, r_idx)
local _ = r_idx
local lnum, col = unpack(plist[idx])
local text, chunks
if nearest then
text = ('[%d/%d]'):format(idx, #plist)
chunks = {{' ', 'Ignore'}, {text, 'VM_Extend'}}
else
text = ('[%d]'):format(idx)
chunks = {{' ', 'Ignore'}, {text, 'HlSearchLens'}}
end
render.set_virt(0, lnum - 1, col - 1, chunks, nearest)
end
function M.start()
if hlslens then
config = require('hlslens.config')
lens_backup = config.override_lens
config.override_lens = override_lens
hlslens.start(true)
end
end
function M.exit()
if hlslens then
config.override_lens = lens_backup
hlslens.start(true)
end
end
return M
hlslens-vm.mp4
- If you get an issue or come up with an awesome idea, don't hesitate to open an issue in github.
- If you think this plugin is useful or cool, consider rewarding it a star.
The project is licensed under a BSD-3-clause license. See LICENSE file for details.