Treesitter playground integrated into Neovim
  • Lua 98.4%
  • Vim Script 1%
  • Tree-sitter Query 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2022-09-03 12:07:07 +02:00
.github/workflows Add CI checks 2021-07-04 20:45:25 -05:00
after/ftplugin feat: add omnifunc for query filetype 2021-05-07 16:55:26 +02:00
lua fix: handle errors in query editor (#93) 2022-09-03 12:07:07 +02:00
plugin feat!: update to Neovim 0.7 APIs (#75) 2022-05-01 15:46:01 +02:00
queries/query Query linter: update queries 2021-07-13 08:51:53 -05:00
syntax refactor(printer): integrate injected languages 2021-01-19 06:45:52 -06:00
.editorconfig Initial commit 2020-07-23 08:07:28 -05:00
.luacheckrc Add CI checks 2021-07-04 20:45:25 -05:00
.stylua.toml Add CI checks 2021-07-04 20:45:25 -05:00
demo.gif add cleanup logic and update readme 2020-07-24 14:19:16 -05:00
LICENSE Initial commit 2020-07-23 08:07:28 -05:00
README.md Fix typo 2021-07-05 18:38:44 -05:00

Neovim Treesitter Playground

View treesitter information directly in Neovim!

nvim-treesitter-playground

Requirements

Setup

Install the plugin (vim-plug shown):

Plug 'nvim-treesitter/nvim-treesitter'
Plug 'nvim-treesitter/playground'

It's also recommended that you install the query parser for query editor highlighting. Run this after installing the above plugins.

:TSInstall query

The configuration is like any other nvim-treesitter module.

require "nvim-treesitter.configs".setup {
  playground = {
    enable = true,
    disable = {},
    updatetime = 25, -- Debounced time for highlighting nodes in the playground from source code
    persist_queries = false, -- Whether the query persists across vim sessions
    keybindings = {
      toggle_query_editor = 'o',
      toggle_hl_groups = 'i',
      toggle_injected_languages = 't',
      toggle_anonymous_nodes = 'a',
      toggle_language_display = 'I',
      focus_language = 'f',
      unfocus_language = 'F',
      update = 'R',
      goto_node = '<cr>',
      show_help = '?',
    },
  }
}

Usage

The tree can be toggled using the command :TSPlaygroundToggle.

Keybindings

  • R: Refreshes the playground view when focused or reloads the query when the query editor is focused.
  • o: Toggles the query editor when the playground is focused.
  • a: Toggles visibility of anonymous nodes.
  • i: Toggles visibility of highlight groups.
  • I: Toggles visibility of the language the node belongs to.
  • t: Toggles visibility of injected languages.
  • f: Focuses the language tree under the cursor in the playground. The query editor will now be using the focused language.
  • F: Unfocuses the currently focused language.
  • <cr>: Go to current node in code buffer

Query Editor

Press o to show the query editor. Write your query like (node) @capture, put the cursor under the capture to highlight the matches.

Completions

When you are on a query buffer, you can get a list of suggestions with Ctrl-X Ctrl-O. See :h 'omnifunc'.

Query Linter

The playground can lint query files for you. For that, you need to activate the query_linter module:

require "nvim-treesitter.configs".setup {
  query_linter = {
    enable = true,
    use_virtual_text = true,
    lint_events = {"BufWrite", "CursorHold"},
  },
}

image

Show treesitter and syntax highlight groups under the cursor

The playground comes with :TSHighlightCapturesUnderCursor that shows any treesitter or syntax highlight groups under the cursor.

image

image