Struct tree_sitter_highlight::HighlightConfiguration [−][src]
pub struct HighlightConfiguration {
pub language: Language,
pub query: Query,
// some fields omitted
}
Expand description
Contains the data neeeded to higlight code written in a particular language.
This struct is immutable and can be shared between threads.
Fields
language: Language
query: Query
Implementations
Creates a HighlightConfiguration
for a given Language
and set of highlighting
queries.
Parameters
language
- The Tree-sitterLanguage
that should be used for parsing.highlights_query
- A string containing tree patterns for syntax highlighting. This should be non-empty, otherwise no syntax highlights will be added.injections_query
- A string containing tree patterns for injecting other languages into the document. This can be empty if no injections are desired.locals_query
- A string containing tree patterns for tracking local variable definitions and references. This can be empty if local variable tracking is not needed.
Returns a HighlightConfiguration
that can then be used with the highlight
method.
Get a slice containing all of the highlight names used in the configuration.
Set the list of recognized highlight names.
Tree-sitter syntax-highlighting queries specify highlights in the form of dot-separated
highlight names like punctuation.bracket
and function.method.builtin
. Consumers of
these queries can choose to recognize highlights with different levels of specificity.
For example, the string function.builtin
will match against function.method.builtin
and function.builtin.constructor
, but will not match function.method
.
When highlighting, results are returned as Highlight
values, which contain the index
of the matched highlight this list of highlight names.