Back to Snacks Nvim

🍿 words

docs/words.md

2.31.01.4 KB
Original Source

🍿 words

Auto-show LSP references and quickly navigate between them

<!-- docgen -->

📦 Setup

lua
-- lazy.nvim
{
  "folke/snacks.nvim",
  ---@type snacks.Config
  opts = {
    words = {
      -- your words configuration comes here
      -- or leave it empty to use the default settings
      -- refer to the configuration section below
    }
  }
}

⚙️ Config

lua
---@class snacks.words.Config
---@field enabled? boolean
{
  debounce = 200, -- time in ms to wait before updating
  notify_jump = false, -- show a notification when jumping
  notify_end = true, -- show a notification when reaching the end
  foldopen = true, -- open folds after jumping
  jumplist = true, -- set jump point before jumping
  modes = { "n", "i", "c" }, -- modes to show references
  filter = function(buf) -- what buffers to enable `snacks.words`
    return vim.g.snacks_words ~= false and vim.b[buf].snacks_words ~= false
  end,
}

📦 Module

Snacks.words.clear()

lua
Snacks.words.clear()

Snacks.words.disable()

lua
Snacks.words.disable()

Snacks.words.enable()

lua
Snacks.words.enable()

Snacks.words.is_enabled()

lua
---@param opts? number|{buf?:number, modes:boolean} if modes is true, also check if the current mode is enabled
Snacks.words.is_enabled(opts)

Snacks.words.jump()

lua
---@param count? number
---@param cycle? boolean
Snacks.words.jump(count, cycle)