coc-highlight

coc-highlight

Provide filetype irrelevant highlights to coc.nvim, including document highlight (highlight of current document symbol) and color highlights.

Important the implementation from version 2.0.0 have changed from language server to worker threads, and only changed lines are calculated for colors.

Install

In your vim/neovim, run command:

:CocInstall coc-highlight

Features

• Highlight the same word symbols of word under cursor.
• Add color highlights to buffers when enabled.

Document symbol highlighting requires a recent coc.nvim build that provides workspace.computeWordRanges; color highlighting remains available on older builds.

Usage

To enable highlight current symbol on CursorHold, add:

autocmd CursorHold * silent call CocActionAsync('highlight')

to your .vimrc or use the coc_current_word plugin which provides configurable delayed highlighting independently from the user's updatetime setting.

Color highlighting is enabled for all filetypes by default. To enable it explicitly, use:

{
  "highlight.colors.enable": true
}

to your settings.json.

To pick a different color, use command:

:call CocAction('pickColor')

Note: only works on Mac or have python gtk module installed.

To pick a different color presentation, use command:

:call CocAction('colorPresentation')

Options

• highlight.trace: Trace level for colors highlight. default: "messages" Valid options: ["off","messages","verbose"]
• highlight.disableLanguages: List of filetypes to ignore. default: []
• highlight.document.enable: Set to false disable document highlight of current symbol, reload coc.nvim required on change, default: true
• highlight.colors.enable: Set to false to disable color highlight, reload coc.nvim required on change, default: true
• highlight.colorNames.enable: Set to false to disable highlight of color names, default: true

F.A.Q

Q: Why color highlight is not shown on my vim?

A: For terminal vim, you have to enable 24-bit RGB color by set termguicolors and make sure your terminal support true colors. To make sure the highlight is not disabled, enable verbose output by "highlight.trace": "verbose" in configuration file and checkout the output by :CocCommand workspace.showOutput highlight.

Q: How to change highlight of the current symbol.

A: All you need is overwrite the highlight group, checkout :h coc-highlights

License

MIT