Lightweight alternative to context.vim
Neovim >= v0.9.0
Note: if you need support for Neovim 0.6.x please use the tag compat/0.6
.
Note: support for specific languages is strictly community maintained and can break from time to time as parsers are updated.
apex
bash
c
c_sharp
capnp
clojure
cmake
cpp
css
cuda
cue
d
dart
devicetree
elixir
elm
fennel
fish
fortran
gdscript
glimmer
go
graphql
groovy
haskell
html_tags
ini
janet
(using the "janet_simple" grammar)java
javascript
json
jsonnet
julia
latex
liquidsoap
lua
markdown
matlab
nim
nix
norg
objdump
ocaml_interface
ocaml
odin
php
php_only
prisma
proto
python
r
ruby
(and rspec
)rust
scala
scss
smali
solidity
svelte
swift
tact
tcl
teal
templ
terraform
toml
tsx
typescript
typoscript
usd
verilog
vhdl
vim
vue
xml
yaml
yang
zig
ada
agda
arduino
astro
beancount
bibtex
bicep
blueprint
chatito
clojure
commonlisp
cooklang
cpon
dhall
dockerfile
dot
ebnf
ecma
eex
elsa
elvish
embedded_template
erlang
fennel
foam
fsh
func
fusion
gdscript
git_rebase
gleam
glsl
godot_resource
gomod
gosum
gowork
hack
hcl
heex
hjson
hlsl
hocon
html
htmldjango
http
jq
jsdoc
json5
jsonc
jsx
kdl
kotlin
lalrpop
ledger
llvm
m68k
markdown_inline
menhir
mermaid
meson
nickel
ocamllex
pascal
perl
phpdoc
pioasm
po
poe_filter
prql
pug
ql
qmldir
qmljs
query
racket
rasi
rego
rnoweb
ron
rst
scheme
slint
smithy
sparql
sql
starlark
supercollider
surface
sxhkdrc
t32
thrift
tiger
tlaplus
todotxt
turtle
twig
ungrammar
v
vala
vhs
wgsl
wgsl_bevy
yuck
(Default values are shown below)
Note: calling setup()
is optional.
require'treesitter-context'.setup{
enable = true, -- Enable this plugin (Can be enabled/disabled later via commands)
multiwindow = false, -- Enable multiwindow support.
max_lines = 0, -- How many lines the window should span. Values <= 0 mean no limit.
min_window_height = 0, -- Minimum editor window height to enable context. Values <= 0 mean no limit.
line_numbers = true,
multiline_threshold = 20, -- Maximum number of lines to show for a single context
trim_scope = 'outer', -- Which context lines to discard if `max_lines` is exceeded. Choices: 'inner', 'outer'
mode = 'cursor', -- Line used to calculate context. Choices: 'cursor', 'topline'
-- Separator between context and content. Should be a single character string, like '-'.
-- When separator is set, the context will only show up when there are at least 2 lines above cursorline.
separator = nil,
zindex = 20, -- The Z-index of the context window
on_attach = nil, -- (fun(buf: integer): boolean) return false to disable attaching
}
TSContextEnable
, TSContextDisable
and TSContextToggle
.
Use the highlight group TreesitterContext
to change the colors of the
context. Per default it links to NormalFloat
.
Use the highlight group TreesitterContextLineNumber
to change the colors of the
context line numbers if line_numbers
is set. Per default it links to LineNr
.
Use the highlight group TreesitterContextSeparator
to change the colors of the
separator if separator
is set. By default it links to FloatBorder
.
Use the highlight groups TreesitterContextBottom
and/or
TreesitterContextLineNumberBottom
to change the highlight of the last line of
the context window. By default it links to NONE
.
However, you can use this to create a border by applying an underline highlight, e.g,
for an underline across the screen:
hi TreesitterContextBottom gui=underline guisp=Grey
hi TreesitterContextLineNumberBottom gui=underline guisp=Grey
Or an underline below the line numbers only:
hi TreesitterContextLineNumberBottom gui=underline guisp=Grey
vim.keymap.set("n", "[c", function()
require("treesitter-context").go_to_context(vim.v.count1)
end, { silent = true })
See CONTRIBUTING.md
Read CONTRIBUTING.md first.
You can provide you own language files by adding them to the
runtimepath
(:help runtimepath
).
For example, creating ~/.config/nvim/queries/java/context.scm
will take
precedence over the queries/java/context.scm
included in nvim-treesitter-context
as long as ~/.config/nvim
appears earlier in runtimepath
.
You can check the value of runtimepath
with :set rtp
.