snacks.nvim/docs/input.md

🍿 input

📦 Setup

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

⚙️ Config

---@class snacks.input.Config
---@field enabled? boolean
---@field win? snacks.win.Config
---@field icon? string
{
  icon = " ",
  icon_hl = "SnacksInputIcon",
  win = { style = "input" },
  expand = true,
}

🎨 Styles

input

{
  backdrop = false,
  position = "float",
  border = "rounded",
  title_pos = "center",
  height = 1,
  width = 60,
  relative = "editor",
  row = 2,
  -- relative = "cursor",
  -- row = -3,
  -- col = 0,
  wo = {
    winhighlight = "NormalFloat:SnacksInputNormal,FloatBorder:SnacksInputBorder,FloatTitle:SnacksInputTitle",
  },
  keys = {
    i_esc = { "<esc>", { "cmp_close", "cancel" }, mode = "i" },
    -- i_esc = { "<esc>", "stopinsert", mode = "i" },
    i_cr = { "<cr>", { "cmp_accept", "confirm" }, mode = "i" },
    i_tab = { "<tab>", { "cmp_select_next", "cmp" }, mode = "i" },
    q = "cancel",
  },
}

📚 Types

---@class snacks.input.Opts: snacks.input.Config
---@field prompt? string
---@field default? string
---@field completion? string
---@field highlight? fun()

📦 Module

Snacks.input()

---@type fun(opts: snacks.input.Opts, on_confirm: fun(value?: string)): snacks.win
Snacks.input()

Snacks.input.complete()

---@param findstart number
---@param base string
Snacks.input.complete(findstart, base)

Snacks.input.disable()

Snacks.input.disable()

Snacks.input.enable()

Snacks.input.enable()

Snacks.input.health()

Snacks.input.health()

Snacks.input.input()

---@param opts? snacks.input.Opts
---@param on_confirm fun(value?: string)
Snacks.input.input(opts, on_confirm)

Snacks.input.test()

Snacks.input.test()