Taman Bermain Pengasuh Pohon Neovim

Lihat informasi treesitter langsung di Neovim!

demo

Pemberitahuan penghentian

Plugin ini tidak digunakan lagi karena fungsinya disertakan dalam Neovim: Gunakan

:Inspect untuk menampilkan grup sorotan di bawah kursor
:InspectTree untuk menampilkan pohon sintaksis yang diurai ("TSPlayground")
:EditQuery untuk membuka Editor Kueri Langsung (Nvim 0.10+)

Persyaratan

Neovim setiap malam
plugin nvim-treesitter (dengan tata bahasa query terpasang)

Pengaturan

Instal plugin (vim-plug ditampilkan):

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

Anda juga disarankan untuk menginstal pengurai query untuk penyorotan editor kueri. Jalankan ini setelah menginstal plugin di atas.

:TSInstall query

Konfigurasinya seperti modul nvim-treesitter lainnya.

 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 = '  ' ,
      show_help = ' ? ' ,
    },
  }
}

Penggunaan

Pohon dapat diubah menggunakan perintah :TSPlaygroundToggle .

Pengikatan kunci

R : Menyegarkan tampilan taman bermain saat fokus atau memuat ulang kueri saat editor kueri fokus.
o : Mengalihkan editor kueri saat taman bermain difokuskan.
a : Mengalihkan visibilitas node anonim.
i : Mengalihkan visibilitas grup sorotan.
I : Mengalihkan visibilitas bahasa yang digunakan node.
t : Mengalihkan visibilitas bahasa yang dimasukkan.
f : Memfokuskan pohon bahasa di bawah kursor di taman bermain. Editor kueri sekarang akan menggunakan bahasa fokus.
F : Tidak fokus pada bahasa yang sedang difokuskan.
: Pergi ke node saat ini dalam buffer kode

Editor Kueri

Tekan o untuk menampilkan editor kueri. Tulis kueri Anda seperti (node) @capture , letakkan kursor di bawah tangkapan untuk menyorot kecocokan.

Penyelesaian

Saat Anda berada di buffer query , Anda bisa mendapatkan daftar saran dengan Ctrl-X Ctrl-O . Lihat :h 'omnifunc' .

Linter Kueri

Taman bermain dapat memasukkan file kueri untuk Anda. Untuk itu, Anda perlu mengaktifkan modul query_linter :

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

Catatan: Linter kueri mengasumsikan struktur direktori tertentu untuk mengidentifikasi kueri bahasa mana yang termasuk. Ia mengharapkan file kueri berada di bawah ./queries/

gambar

Tampilkan grup treesitter dan highlight sintaksis di bawah kursor

Taman bermain dilengkapi dengan :TSHighlightCapturesUnderCursor yang menampilkan grup treesitter atau highlight sintaksis di bawah kursor.

Tampilkan node treesitter di bawah kursor

Jika Anda hanya ingin melihat informasi tentang node tempat kursor Anda berada saat ini (tanpa harus membuka pohon secara keseluruhan), Anda dapat menggunakan :TSNodeUnderCursor sebagai gantinya. Jendela mengambang yang berisi informasi tentang parser, nama node, dan rentang baris/kolom akan ditampilkan.