plugins.toggleterm.extraOptions.auto_scroll

Automatically scroll to the bottom on terminal output.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.autochdir

When neovim changes it current directory the terminal will change it’s own when next it’s opened.

Type: null or boolean or raw lua code

Default: null

Plugin default: false

Declared by:

plugins.toggleterm.extraOptions.close_on_exit

Close the terminal window when the process exits.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.direction

The direction the terminal should be opened in.

Type: null or one of “vertical”, “horizontal”, “tab”, “float” or raw lua code

Default: null

Plugin default: "horizontal"

Declared by:

plugins.toggleterm.extraOptions.hide_numbers

Hide the number column in toggleterm buffers.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.highlights

Highlights which map a highlight group name to an attrs of it’s values.

Type: null or (attribute set of ((attribute set) or raw lua code))

Default: null

Plugin default:

{
  NormalFloat.link = "Normal";
  FloatBorder.link = "Normal";
  StatusLine.gui = "NONE";
  StatusLineNC = {
    cterm = "italic";
    gui = "NONE";
  };
}

Declared by:

plugins.toggleterm.extraOptions.insert_mappings

Whether or not the open mapping applies in insert mode.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.on_close

Function to run when the terminal closes.

fun(t: Terminal)

Type: null or lua code string

Default: null

Declared by:

plugins.toggleterm.extraOptions.on_create

Function to run when the terminal is first created.

fun(t: Terminal)

Type: null or lua code string

Default: null

Declared by:

plugins.toggleterm.extraOptions.on_exit

Function to run when terminal process exits.

fun(t: Terminal, job: number, exit_code: number, name: string)

Type: null or lua code string

Default: null

Declared by:

plugins.toggleterm.extraOptions.on_open

Function to run when the terminal opens.

fun(t: Terminal)

Type: null or lua code string

Default: null

Declared by:

plugins.toggleterm.extraOptions.on_stderr

Callback for processing output on stderr.

fun(t: Terminal, job: number, data: string[], name: string)

Type: null or lua code string

Default: null

Declared by:

plugins.toggleterm.extraOptions.on_stdout

Callback for processing output on stdout.

fun(t: Terminal, job: number, data: string[], name: string)

Type: null or lua code string

Default: null

Declared by:

plugins.toggleterm.extraOptions.open_mapping

Setting the open_mapping key to use for toggling the terminal(s) will set up mappings for normal mode.

Type: null or lua code string

Default: null

Declared by:

plugins.toggleterm.extraOptions.persist_mode

If set to true (default) the previous terminal mode will be remembered.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.persist_size

Whether the terminal size should persist.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.shade_filetypes

Shade filetypes.

Type: null or (list of (string or raw lua code))

Default: null

Plugin default: []

Declared by:

plugins.toggleterm.extraOptions.shade_terminals

NOTE: This option takes priority over highlights specified so if you specify Normal highlights you should set this to false.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.shading_factor

The percentage by which to lighten terminal background.

default: -30 (gets multiplied by -3 if background is light).

Type: null or signed integer

Default: null

Declared by:

plugins.toggleterm.extraOptions.shell

Change the default shell.

Type: null or string or raw lua code

Default: null

Plugin default: "{__raw = \"vim.o.shell\";}"

Declared by:

plugins.toggleterm.extraOptions.size

Size of the terminal. size can be a number or a function.

Example:

  size = 20

OR

size = \'\'
  function(term)
    if term.direction == "horizontal" then
      return 15
    elseif term.direction == "vertical" then
      return vim.o.columns * 0.4
    end
  end
\'\';

Type: null or lua function string or signed integer or floating point number

Default: null

Plugin default: 12

Declared by:

plugins.toggleterm.extraOptions.start_in_insert

Whether to start toggleterm in insert mode.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by:

plugins.toggleterm.extraOptions.terminal_mappings

Whether or not the open mapping applies in the opened terminals.

Type: null or boolean or raw lua code

Default: null

Plugin default: true

Declared by: