Vim plugin for selectively illuminating other uses of the current word under the cursor
All modern IDEs and editors will highlight the word under the cursor which is a great way to see other uses of the current variable without having to look for it.
This plugin is a tool for illuminating the other uses of the current word under the cursor.
Illuminate will by default highlight all uses of the word under the cursor, but with a little bit of configuration it can easily only highlight what you want it to highlight based on the filetype and highlight-groups.
Illuminate will also do a few other niceties such as delaying the highlight for a user-defined amount of time based on g:Illuminate_delay
(by default 250), it will interact nicely with search highlighting, jumping around between buffers, jumping around between windows, and won't illuminate while in insert mode.
Illuminate will delay before highlighting, this is not lag, it is to avoid the jarring experience of things illuminating too fast. This can be controlled with g:Illuminate_delay
(which is default to 250 milliseconds):
Note: Delay only works for Vim8 and Neovim.
" Time in milliseconds (default 250)
let g:Illuminate_delay = 250
Illuminate will by default highlight the word under the cursor to match the behaviour seen in Intellij and VSCode. However, to make it not highlight the word under the cursor, use the following:
" Don't highlight word under cursor (default: 1)
let g:Illuminate_highlightUnderCursor = 0
By default illuminate will highlight all words the cursor passes over, but for many languages, you will only want to highlight certain highlight-groups (you can determine the highlight-group of a symbol under your cursor with :echo synIDattr(synIDtrans(synID(line("."), col("."), 1)), "name")
).
You can define which highlight groups you want the illuminating to apply to. This can be done with a dict mapping a filetype to a list of highlight-groups in your vimrc such as:
let g:Illuminate_ftHighlightGroups = {
\ 'vim': ['vimVar', 'vimString', 'vimLineComment',
\ 'vimFuncName', 'vimFunction', 'vimUserFunc', 'vimFunc']
\ }
illuminate can also be disabled for various filetypes using the following:
let g:Illuminate_ftblacklist = ['nerdtree']
Lastly, by default the highlighting will be done with the hl-group CursorLine
since that is in my opinion the nicest. It can however be overridden using the following or something similar:
hi illuminatedWord cterm=underline gui=underline
This assumes you have the packages feature. If not, any plugin manager will suffice.
mkdir -p ~/.config/nvim/pack/plugins/start
cd ~/.config/nvim/pack/plugins/start
git clone https://github.com/RRethy/vim-illuminate.git
mkdir -p ~/.vim/pack/plugins/start
cd ~/.vim/pack/plugins/start
git clone https://github.com/RRethy/vim-illuminate.git
I am seeing by default an underline for the matched words
Try this: hi link illuminatedWord Visual
. The reason for the underline is that the highlighting is done with CursorLine
by default, which defaults to an underline.