Highlight colors within Neovim
![Background highlights for hex, rgb, hsl, named colors, and CSS variables](https://private-user-images.githubusercontent.com/1474821/313786646-d99a800c-0ea9-44f9-bc1c-986236adf44a.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTg5MjAwOTUsIm5iZiI6MTcxODkxOTc5NSwicGF0aCI6Ii8xNDc0ODIxLzMxMzc4NjY0Ni1kOTlhODAwYy0wZWE5LTQ0ZjktYmMxYy05ODYyMzZhZGY0NGEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDYyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA2MjBUMjE0MzE1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZjE0ZWUyNzcyZmNhNDlmODljOTMwZGJhNmI4MzYwNTk2MzE4NmFjZWUwMWQ5MWI3ZTk5ZGExNDk3MjY4NGE0OSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.mkyfkvIrM_d78WsMqAscE3dt1iDQWVQXd-RSXyBUmJg)
- Realtime color highlighting
- Supports hex, rgb, hsl, CSS variables, and Tailwind CSS
- LSP support! For any LSP that supports
textDocument/documentColor
like tailwindcss - Multiple rendering modes: background, foreground, and virtual text
Install via your preferred package manager:
'brenoprata10/nvim-highlight-colors'
Initialize the plugin:
-- Ensure termguicolors is enabled if not already
vim.opt.termguicolors = true
require('nvim-highlight-colors').setup({})
require("nvim-highlight-colors").setup {
---Render style
---@usage 'background'|'foreground'|'virtual'
render = 'background',
---Set virtual symbol (requires render to be set to 'virtual')
virtual_symbol = '■',
---Set virtual symbol suffix (defaults to '')
virtual_symbol_prefix = '',
---Set virtual symbol suffix (defaults to ' ')
virtual_symbol_suffix = ' ',
---Set virtual symbol position()
---@usage 'inline'|'eol'|'eow'
---inline mimics VS Code style
---eol stands for `end of column` - Recommended to set `virtual_symbol_suffix = ''` when used.
---eow stands for `end of word` - Recommended to set `virtual_symbol_prefix = ' ' and virtual_symbol_suffix = ''` when used.
virtual_symbol_position = 'inline',
---Highlight hex colors, e.g. '#FFFFFF'
enable_hex = true,
---Highlight short hex colors e.g. '#fff'
enable_short_hex = true,
---Highlight rgb colors, e.g. 'rgb(0 0 0)'
enable_rgb = true,
---Highlight hsl colors, e.g. 'hsl(150deg 30% 40%)'
enable_hsl = true,
---Highlight CSS variables, e.g. 'var(--testing-color)'
enable_var_usage = true,
---Highlight named colors, e.g. 'green'
enable_named_colors = true,
---Highlight tailwind colors, e.g. 'bg-blue-500'
enable_tailwind = false,
---Set custom colors
---Label must be properly escaped with '%' to adhere to `string.gmatch`
--- :help string.gmatch
custom_colors = {
{ label = '%-%-theme%-primary%-color', color = '#0f1219' },
{ label = '%-%-theme%-secondary%-color', color = '#5a5d64' },
},
-- Exclude filetypes or buftypes from highlighting e.g. 'exclude_buftypes = {'text'}'
exclude_filetypes = {},
exclude_buftypes = {}
}
Examples shown use
enable_tailwind = true
Background
![Background highlights for named colors, CSS variables, and Tailwind CSS colors](https://private-user-images.githubusercontent.com/1474821/313771591-bf8c0d2d-552c-485a-aeba-b3d281c8c333.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTg5MjAwOTUsIm5iZiI6MTcxODkxOTc5NSwicGF0aCI6Ii8xNDc0ODIxLzMxMzc3MTU5MS1iZjhjMGQyZC01NTJjLTQ4NWEtYWViYS1iM2QyODFjOGMzMzMucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDYyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA2MjBUMjE0MzE1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9Zjg4NjUxMWFmNWY5M2VjYTZkMjZhN2VhYmRlMmM4YjFkZGM5YjVkMGYzZDI2NWI5YmQ5NWYyZWFjZGY3NDUzZCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.LwoFabmMtYPkx8q0H4eO3rtgjXqG3dMsMXUElGiTDPs)
Foreground
![Foreground highlights for named colors, CSS variables, and Tailwind CSS colors](https://private-user-images.githubusercontent.com/1474821/313771551-4e2e9c7d-552b-4558-ab79-4fe37738f869.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTg5MjAwOTUsIm5iZiI6MTcxODkxOTc5NSwicGF0aCI6Ii8xNDc0ODIxLzMxMzc3MTU1MS00ZTJlOWM3ZC01NTJiLTQ1NTgtYWI3OS00ZmUzNzczOGY4NjkucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDYyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA2MjBUMjE0MzE1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MmVjOTBiM2QzNWVhOWQ3Y2UxYzU4MThhM2JmZjYzYWQ2ZWYyNDM4OGZmNGQ4MTE4NjhhNDA3NzExYmRhZGZhYSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.-akDLM2IyDHb0KeRJbvUCN4RIGMXgV0k_j41xvFHUUA)
Virtual text
![Virtual text highlights for named colors, CSS variables, and Tailwind CSS colors](https://private-user-images.githubusercontent.com/1474821/313771534-536b16e4-04ad-4ede-95f5-c1855386c294.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MTg5MjAwOTUsIm5iZiI6MTcxODkxOTc5NSwicGF0aCI6Ii8xNDc0ODIxLzMxMzc3MTUzNC01MzZiMTZlNC0wNGFkLTRlZGUtOTVmNS1jMTg1NTM4NmMyOTQucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDYyMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA2MjBUMjE0MzE1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZjBmOTgzYjhiNDVkYzEwZTU2YzhmOWI4NzY4YjE2NThkNWZiYjQ5ODdmYzQwMWI2ZDE5ZjZhOWI2OTg1ZDZmMSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.B7D7i7s_czAbtbtp8qv7iRRUpFM8-9dmQCHo18rfmHk)
Command | Description |
---|---|
:HighlightColors On |
Turn highlights on |
:HighlightColors Off |
Turn highlights off |
:HighlightColors Toggle |
Toggle highlights |
Commands are also available in lua:
require("nvim-highlight-colors").turnOn()
require("nvim-highlight-colors").turnOff()
require("nvim-highlight-colors").toggle()