Input Nvim

Opinionated, simple replacement for vim.ui.input.

🚀 Installation

{
  "cpea2506/input.nvim"
}

Requirements

• Neovim >= 0.11.0

⚙️ Setup

This plugin works immediately after installation. Configuration is optional, only needed if you want to override defaults.

Available Options

Option	Description	Type	Notes
icon	Icon displayed next to the prompt	string	N/A
default_prompt	Default text for the prompt	string	N/A
win_options	Window-level Vim options	table<string, any>	See :h nvim_win_set_option
buf_options	Buffer-level Vim options	table<string, any>	See :h nvim_buf_set_option
win_config	Window configuration for nvim_open_win	table<string, any>	See :h nvim_open_win
width_options	Dynamic width settings	table<string, any>	See Width Options

Width Options

Sub-Option	Description	Type	Notes
prefer	Preferred input width	number	Default target width
min_value	Minimum allowed width	{number, number}	Fixed width or ratio of window width
max_value	Maximum allowed width	{number, number}	Fixed width or ratio of window width

Default Configuration

require("input").setup({
    icon = "",
    default_prompt = "Input",
    win_options = {
        wrap = false,
        list = true,
        listchars = "precedes:…,extends:…",
        sidescrolloff = 0,
    },
    buf_options = {},
    win_config = {
        relative = "cursor",
        anchor = "NW",
        border = vim.o.winborder,
        row = 1,
        col = 1,
        width = 40,
        height = 1,
        focusable = false,
        noautocmd = true,
        style = "minimal",
    },
    width_options = {
        prefer = 40,
        min_value = { 20, 0.2 },
        max_value = { 140, 0.9 },
    },
})

⌨️ Key Mappings

These are the default key mappings:

Keybinding	Mode(s)	Action
<C-c>	i, n	Cancel content changes and close input
q	n	Cancel content changes and close input
<CR>	i, n	Confirm content changes and close input

🎨 Highlights

Highlight Group	Purpose
InputIcon	Status column icon, which displayed before the prompt

To customize highlights for the plugin window:

require("input").setup({
  win_options = {
    winhighlight = "NormalFloat:DiagnosticError"
  }
})

For more, see :h winhighlight.

👀 Inspiration

• dressing.nvim

📜 Contribution

For detailed instructions on how to contribute to this plugin, please see the contributing guidelines.