สนามเด็กเล่น Neovim Treesitter

ดูข้อมูลผู้ปลูกต้นไม้โดยตรงใน Neovim!

การสาธิต

ประกาศการเลิกใช้งาน

ปลั๊กอินนี้ เลิกใช้แล้ว เนื่องจากมีฟังก์ชันการทำงานรวมอยู่ใน Neovim: Use

:Inspect เพื่อแสดงกลุ่มไฮไลท์ใต้เคอร์เซอร์
:InspectTree เพื่อแสดงแผนผังไวยากรณ์แยกวิเคราะห์ ("TSPlayground")
:EditQuery เพื่อเปิดตัวแก้ไข Live Query (Nvim 0.10+)

ความต้องการ

นีโอวิมทุกคืน
ปลั๊กอิน nvim-treesitter (พร้อมติดตั้งไวยากรณ์ query )

ตั้งค่า

ติดตั้งปลั๊กอิน (แสดง vim-plug):

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

ขอแนะนำให้คุณติดตั้งตัวแยกวิเคราะห์ query สำหรับการเน้นตัวแก้ไขแบบสอบถาม เรียกใช้สิ่งนี้หลังจากติดตั้งปลั๊กอินด้านบน

:TSInstall query

การกำหนดค่าก็เหมือนกับโมดูล nvim-treesitter อื่นๆ

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

การใช้งาน

คุณสามารถสลับแผนผังได้โดยใช้คำสั่ง :TSPlaygroundToggle

การโยงคีย์

R : รีเฟรชมุมมอง Playground เมื่อโฟกัสหรือโหลดแบบสอบถามซ้ำเมื่อโฟกัสตัวแก้ไขแบบสอบถาม
o : สลับตัวแก้ไขแบบสอบถามเมื่อ Playground ถูกโฟกัส
a : สลับการมองเห็นโหนดที่ไม่ระบุชื่อ
i : สลับการมองเห็นกลุ่มไฮไลท์
I : สลับการมองเห็นภาษาที่โหนดนั้นอยู่
t : สลับการมองเห็นภาษาที่ฉีด
f : โฟกัสแผนผังภาษาใต้เคอร์เซอร์ใน Playground ขณะนี้ตัวแก้ไขแบบสอบถามจะใช้ภาษาที่เน้น
F : เลิกโฟกัสภาษาที่โฟกัสอยู่ในปัจจุบัน
<cr> : ไปที่โหนดปัจจุบันในโค้ดบัฟเฟอร์

ตัวแก้ไขแบบสอบถาม

กด o เพื่อแสดงตัวแก้ไขแบบสอบถาม เขียนแบบสอบถามของคุณเช่น (node) @capture วางเคอร์เซอร์ไว้ใต้การจับภาพเพื่อเน้นรายการที่ตรงกัน

สำเร็จ

เมื่อคุณอยู่ในบัฟเฟอร์ query คุณสามารถรับรายการข้อเสนอแนะได้ด้วย Ctrl-X Ctrl-O ดู :h 'omnifunc'

สอบถามลินเตอร์

Playground สามารถรวมไฟล์คิวรีให้คุณได้ เพื่อที่คุณจะต้องเปิดใช้งานโมดูล query_linter :

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

หมายเหตุ: Query linter จะใช้โครงสร้างไดเร็กทอรีบางอย่างเพื่อระบุว่าคิวรีภาษาใดเป็นของ คาดว่าไฟล์แบบสอบถามจะอยู่ภายใต้ ./queries/<language_name>

ภาพ

แสดงกลุ่มไฮไลต์ treeitter และไวยากรณ์ใต้เคอร์เซอร์

Playground มาพร้อมกับ :TSHighlightCapturesUnderCursor ที่แสดงกลุ่มไฮไลต์แบบต้นไม้หรือไวยากรณ์ใต้เคอร์เซอร์

แสดงโหนด treeitter ใต้เคอร์เซอร์

หากคุณต้องการดูข้อมูลเกี่ยวกับโหนดที่เคอร์เซอร์ของคุณเปิดอยู่เท่านั้น (โดยไม่ต้องเปิดทั้งแผนผัง) คุณสามารถใช้ :TSNodeUnderCursor แทน หน้าต่างลอยที่มีข้อมูลเกี่ยวกับ parser ชื่อโหนด และช่วงแถว/คอลัมน์จะปรากฏขึ้น