docs(tree-sitter): document highlight priority

This commit is contained in:
Stephan Seitz 2021-07-18 15:27:54 +02:00
parent 242608e669
commit 5ea6cc1d75
2 changed files with 16 additions and 2 deletions

View File

@ -2334,8 +2334,9 @@ nvim_buf_set_extmark({buffer}, {ns_id}, {line}, {col}, {opts})
inserted (true for right, false for left).
Defaults to false.
• priority: a priority value for the highlight
group. For example treesitter highlighting
uses a value of 100.
group. Default: 4096. For example, treesitter
highlighting uses a default value of 100 (see
|lua-treesitter-highlight-priority|).
Return: ~
Id of the created/updated extmark

View File

@ -294,6 +294,19 @@ identical identifiers, highlighting both as |hl-WarningMsg|: >
((binary_expression left: (identifier) @WarningMsg.left right: (identifier) @WarningMsg.right)
(eq? @WarningMsg.left @WarningMsg.right))
<
Treesitter Highlighting Priority *lua-treesitter-highlight-priority*
Tree-sitter uses |nvim_buf_set_extmark()| to set highlights with a default
priority of 100. This enables plugins to set a highlighting priority lower or
higher than tree-sitter. It is also possible to change the priority of an
individual query pattern manually by setting its `"priority"` metadata attribute: >
(
(super_important_node) @ImportantHighlight
; Give the whole query highlight priority higher than the default (100)
(set! "priority" 105)
)
<
==============================================================================
Lua module: vim.treesitter *lua-treesitter-core*