1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-11 07:03:35 +03:00
wezterm/docs/config/lua/keyassignment/SplitVertical.md
Wez Furlong ba62f4fed0 clarify split docs
I've seen a number of people copy and paste the example that runs
`top` and be confused by it, so try to make it a bit clearer how
to get a regular split with a shell inside it.
2020-12-29 08:40:52 -08:00

828 B

SplitVertical

Since: 20201031-154415-9614e117

Splits the current pane in half vertically such that the current pane becomes the top half and the new bottom half spawns a new command.

local wezterm = require 'wezterm';

return {
  keys = {
    -- This will create a new split and run your default program inside it
    {key="\"", mods="CLTR|SHIFT|ALT",
      action=wezterm.action{SplitVertical={domain="CurrentPaneDomain"}}},
  }
}

SplitVertical requires a SpawnCommand parameter to specify what should be spawned into the new split.

local wezterm = require 'wezterm';

return {
  keys = {
    -- This will create a new split and run the `top` program inside it
    {key="\"", mods="CTRL|SHIFT|ALT", action=wezterm.action{SplitVertical={
      args={"top"}
    }}},
  }
}