snacks.nvim/docs/words.md

🍿 words

Auto-show LSP references and quickly navigate between them

📦 Setup

-- 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

---@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()

Snacks.words.clear()

Snacks.words.disable()

Snacks.words.disable()

Snacks.words.enable()

Snacks.words.enable()

Snacks.words.is_enabled()

---@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()

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