深入解析 WezTerm 的自定義功能：鍵繫結和滑鼠繫結

comsoi發表於2024-11-23

WezTerm 是一個高效能的跨平臺終端模擬器，它提供了廣泛的自定義選項，包括鍵繫結和滑鼠繫結，使得使用者可以根據自己的需求最佳化操作介面。本文將詳細介紹幾個關鍵的自定義功能，解釋它們的用途，並展示如何配置這些功能來提升終端使用體驗。

建立一個鍵繫結

WezTerm 的鍵繫結功能允許使用者為特定的操作定義快捷鍵。需要注意的是如果想要繫結大寫或者特殊字元，需要設定key的同時設定mods，例如：

{ key = 'H', mods = 'SHIFT|LEADER', action = act.AdjustPaneSize { 'Left', 10 } },

這樣配置的快捷鍵可以透過按下 Leader 後，再按下 Shift + h (H) 來調整皮膚大小。

詳見：https://wezfurlong.org/wezterm/config/keys.html

配置 LEADER 鍵

首先，定義一個 LEADER 鍵，作為其他快捷鍵的字首。在 WezTerm 中，LEADER 鍵的設定如下：

local leader = {
	key = 'Space',
	mods = 'SUPER|ALT',
	timeout_milliseconds = math.maxinteger
}

這個設定允許使用者透過同時按下 Win + Alt + Space 來啟用領導鍵模式，實現類似 tmux 的操作方式。

基本的操作：

{ key = "c", mods = "LEADER",       action = act { SpawnTab = "CurrentPaneDomain" } },
{ key = "&", mods = "LEADER",       action = act { CloseCurrentTab = { confirm = false } } },
{ key = "q", mods = "LEADER",       action = act { CloseCurrentTab = { confirm = false } } },
{ key = "x", mods = "LEADER",       action = act { CloseCurrentPane = { confirm = false } } },
{ key = 's', mods = 'LEADER',       action = act.PaneSelect },
{ key = 'S', mods = 'SHIFT|LEADER', action = act.PaneSelect { mode = 'SwapWithActive' } },
{ key = 'w', mods = 'LEADER',       action = act.ShowTabNavigator },
{ key = "k", mods = "LEADER",       action = act.RotatePanes "Clockwise" },

{ key = "T",      mods = "SHIFT|CTRL",   action = act { SpawnTab = "CurrentPaneDomain" } },
{ key = "W",      mods = "SHIFT|CTRL",   action = act { CloseCurrentTab = { confirm = true } } },
{ key = "V",      mods = "SHIFT|CTRL",   action = act { PasteFrom = "Clipboard" } },
{ key = "C",      mods = "SHIFT|CTRL",   action = act { CopyTo = "Clipboard" } },
{ key = "Tab",    mods = "CTRL",         action = act.ActivateTabRelative(1) },
{ key = "Tab",    mods = "SHIFT|CTRL",   action = act.ActivateTabRelative(-1) },
{ key = "Return", mods = "ALT",          action = "ToggleFullScreen" },
{ key = "F11",    mods = "",             action = "ToggleFullScreen" },

皮膚操作：啟用與調整

ALT 風格的配置：

一些程式比如 tmux zellij 等會使用這些快捷鍵，所以這裡自定義 create_keybind 函式來實現識別當前皮膚是否在這些程式中，如果是則不執行對應的操作，而是直接傳遞給程式。create_keybind 函式的實現見完整配置檔案。

create_keybind("SpawnTab", "ALT", "t", "CurrentPaneDomain"),
create_keybind("smart_split", "ALT", "n"),
create_keybind("CloseCurrentTab", "ALT", "q"),
create_keybind("CloseCurrentPane", "ALT", "x"),

create_keybind("ActivatePaneDirection", "ALT", "h", "Left"),
create_keybind("ActivatePaneDirection", "ALT", "j", "Down"),
create_keybind("ActivatePaneDirection", "ALT", "k", "Up"),
create_keybind("ActivatePaneDirection", "ALT", "l", "Right")

create_keybind("ActivatePaneDirection", "ALT", "[", "Prev"),
create_keybind("ActivatePaneDirection", "ALT", "]", "Next"),

create_keybind("AdjustPaneSize", "ALT", "LeftArrow", "Left"),
create_keybind("AdjustPaneSize", "ALT", "RightArrow", "Right"),
create_keybind("AdjustPaneSize", "ALT", "UpArrow", "Up"),
create_keybind("AdjustPaneSize", "ALT", "DownArrow", "Down")

WezTerm Leader 鍵的缺點在於每個 action 都需要按下 Leader 鍵，這樣會導致操作繁瑣。例如，我們如果直接使用

{ key = 'h', mods = 'LEADER', action = act.ActivatePaneDirection 'Left' },
{ key = 'j', mods = 'LEADER', action = act.ActivatePaneDirection 'Down' },
{ key = 'k', mods = 'LEADER', action = act.ActivatePaneDirection 'Up' },
{ key = 'l', mods = 'LEADER', action = act.ActivatePaneDirection 'Right' }

這樣配置的問題在於，使用者每切換一次都需要按下一次 Leader 鍵。為了解決這個問題，我們可以建立一個函式activate_pane_with_dir來啟用指定方向的皮膚，並透過resize_pane_with_dir來調整皮膚大小。這兩個函式會呼叫對應action後，再呼叫ActivateKeyTable來啟用對應的快捷鍵表。這樣就可以像 tmux 一樣，按下一次 Leader 鍵，然後連續按下 hjkl 來切換皮膚。

key_table:

local key_tables = {
	resize_pane = {
		{ key = 'LeftArrow',  action = act.AdjustPaneSize { 'Left', 1 } },
		{ key = 'h',          action = act.AdjustPaneSize { 'Left', 1 } },
		{ key = 'H',          action = act.AdjustPaneSize { 'Left', 10 } },

		{ key = 'RightArrow', action = act.AdjustPaneSize { 'Right', 1 } },
		{ key = 'l',          action = act.AdjustPaneSize { 'Right', 1 } },
		{ key = 'L',          action = act.AdjustPaneSize { 'Right', 10 } },

		{ key = 'UpArrow',    action = act.AdjustPaneSize { 'Up', 1 } },
		{ key = 'k',          action = act.AdjustPaneSize { 'Up', 1 } },
		{ key = 'K',          action = act.AdjustPaneSize { 'Up', 10 } },

		{ key = 'DownArrow',  action = act.AdjustPaneSize { 'Down', 1 } },
		{ key = 'j',          action = act.AdjustPaneSize { 'Down', 1 } },
		{ key = 'J',          action = act.AdjustPaneSize { 'Down', 10 } },

		{ key = 'Escape',     action = 'PopKeyTable' },
		{ key = 'q',          action = 'PopKeyTable' },
		{ key = 'Q',          action = 'PopKeyTable' }
	},
	activate_pane = {
		{ key = 'LeftArrow',  action = act.ActivatePaneDirection 'Left' },
		{ key = 'h',          action = act.ActivatePaneDirection 'Left' },

		{ key = 'RightArrow', action = act.ActivatePaneDirection 'Right' },
		{ key = 'l',          action = act.ActivatePaneDirection 'Right' },

		{ key = 'UpArrow',    action = act.ActivatePaneDirection 'Up' },
		{ key = 'k',          action = act.ActivatePaneDirection 'Up' },

		{ key = 'DownArrow',  action = act.ActivatePaneDirection 'Down' },
		{ key = 'j',          action = act.ActivatePaneDirection 'Down' },

		{ key = 'Escape',     action = 'PopKeyTable' },
		{ key = 'q',          action = 'PopKeyTable' },
		{ key = 'Q',          action = 'PopKeyTable' }
	},
	move_tab = {
		{ key = 'N',          action = act.MoveTabRelative(1) },
		{ key = 'P',          action = act.MoveTabRelative(-1) },

		{ key = 'n',          action = act.MoveTabRelative(1) },
		{ key = 'p',          action = act.MoveTabRelative(-1) },

		{ key = 'h',          action = act.MoveTabRelative(-1) },
		{ key = 'j',          action = act.MoveTabRelative(1) },
		{ key = 'k',          action = act.MoveTabRelative(-1) },
		{ key = 'l',          action = act.MoveTabRelative(1) },

		{ key = 'LeftArrow',  action = act.MoveTabRelative(-1) },
		{ key = 'RightArrow', action = act.MoveTabRelative(1) },
		{ key = 'UpArrow',    action = act.MoveTabRelative(-1) },
		{ key = 'DownArrow',  action = act.MoveTabRelative(1) },

		{ key = 'Escape',     action = 'PopKeyTable' },
		{ key = 'q',          action = 'PopKeyTable' },
		{ key = 'Q',          action = 'PopKeyTable' }
	},
	activate_tab = {
		{ key = 'N',          action = act.ActivateTab(0) },
		{ key = 'P',          action = act.ActivateTab(-1) },

		{ key = 'n',          action = act.ActivateTabRelative(1) },
		{ key = 'p',          action = act.ActivateTabRelative(-1) },

		{ key = 'h',          action = act.ActivateTabRelative(-1) },
		{ key = 'j',          action = act.ActivateTabRelative(1) },
		{ key = 'k',          action = act.ActivateTabRelative(-1) },
		{ key = 'l',          action = act.ActivateTabRelative(1) },

		{ key = 'LeftArrow',  action = act.ActivateTabRelative(-1) },
		{ key = 'RightArrow', action = act.ActivateTabRelative(1) },
		{ key = 'UpArrow',    action = act.ActivateTabRelative(-1) },
		{ key = 'DownArrow',  action = act.ActivateTabRelative(1) },

		{ key = 'Escape',     action = 'PopKeyTable' },

}

local function activate_pane_with_dir(dir)
		return function(win, pane)
				win:perform_action(wezterm.action.ActivatePaneDirection(dir), pane)
				win:perform_action(wezterm.action.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 600 }, pane)
		end
end

local function resize_pane_with_dir(dir)
		return function(win, pane)
				win:perform_action(wezterm.action.AdjustPaneSize { dir, 10 }, pane)
				win:perform_action(wezterm.action.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 600 }, pane)
		end
end

local function activate_tab_with_dir(dir)
	return function(win, pane)
		win:perform_action(act.ActivateTabRelative(dir), pane)
		win:perform_action(act.ActivateKeyTable { name = 'activate_tab', one_shot = false, timeout_milliseconds = 600 },
			pane)
	end
end

local function move_tab_with_dir(dir)
	return function(win, pane)
		win:perform_action(act.MoveTabRelative(dir), pane)
		win:perform_action(act.ActivateKeyTable { name = 'move_tab', one_shot = false, timeout_milliseconds = 600 },
			pane)
	end
end

配置如下：

{ key = "a",          mods = "LEADER",   action = act.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 5000 } },

{ key = 'h',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Left")) },
{ key = 'j',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Down")) },
{ key = 'k',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Up")) },
{ key = 'l',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Right")) },

{ key = "UpArrow",    mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Up")) },
{ key = "DownArrow",  mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Down")) },
{ key = "LeftArrow",  mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Left")) },
{ key = "RightArrow", mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Right")) },

{ key = "h",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } },
{ key = "j",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } },
{ key = "k",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } },
{ key = "l",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } },

{ key = "UpArrow",    mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } },
{ key = "DownArrow",  mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } },
{ key = "LeftArrow",  mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } },
{ key = "RightArrow", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } },


{ key = 'r',          mods = 'LEADER',         action = act.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 5000 } },

-- use Multiple keybinds fails because of async, so use action_callback
{ key = 'H',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Left")) },
{ key = 'J',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Down")) },
{ key = 'K',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Up")) },
{ key = 'L',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Right")) },

{ key = "UpArrow",    mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Up")) },
{ key = "DownArrow",  mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Down")) },
{ key = "LeftArrow",  mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Left")) },
{ key = "RightArrow", mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Right")) },

{ key = "h",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 1 } } },
{ key = "l",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 1 } } },
{ key = "k",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 1 } } },
{ key = "j",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 1 } } },

{ key = "UpArrow",    mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 1 } } },
{ key = "DownArrow",  mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 1 } } },
{ key = "LeftArrow",  mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 1 } } },
{ key = "RightArrow", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 1 } } },

皮膚分割

皮膚分割功能允許使用者在一個視窗（window）中同時開啟多個皮膚（pane），從而可以並行處理多個任務。配置如下：

{ key = "-", mods = "LEADER", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },
{ key = "\\", mods = "LEADER", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },
{ key = "-", mods = "ALT|CTRL", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },
{ key = "\\", mods = "ALT|CTRL", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },
{ key = "_", mods = "SHIFT|CTRL", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },
{ key = "|", mods = "SHIFT|CTRL", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },

透過使用 LEADER,ALT+CTRL,SHIFT+CTRL + - 和 \ 來分別進行垂直和水平分割。

配置智慧分割功能

根據當前皮膚的尺寸來決定是進行垂直分割還是水平分割。

local function smart_split_callback(window, pane)
		local dim = pane:get_dimensions()
		if dim.pixel_height > dim.pixel_width then
				window:perform_action(wezterm.action.SplitVertical({ domain = "CurrentPaneDomain" }), pane)
		else
				window:perform_action(wezterm.action.SplitHorizontal({ domain = "CurrentPaneDomain" }), pane)
		end
end

local smart_split = wezterm.action_callback(smart_split_callback)
keys = {
		{ key = "Enter", mods = "LEADER", action = smart_split },
		{ key = "Enter", mods = "ALT|CTRL", action = smart_split },
		{ key = "Enter", mods = "SHIFT|CTRL", action = smart_split }
}

標籤導航

create_keybind("ActivateTabRelative", "ALT|CTRL", "[", -1),
create_keybind("ActivateTabRelative", "ALT|CTRL", "]", 1),

{ key = "A",          mods = "SHIFT|LEADER", action = act.ActivateKeyTable { name = "activate_tab", one_shot = false, timeout_milliseconds = 5000 } },

{ key = "LeftArrow",  mods = "SHIFT|CTRL",   action = act.ActivateTabRelative(-1) },
{ key = "RightArrow", mods = "SHIFT|CTRL",   action = act.ActivateTabRelative(1) },

{ key = "n",          mods = "LEADER",       action = act.ActivateTabRelative(1) },
{ key = "p",          mods = "LEADER",       action = act.ActivateTabRelative(-1) },

{ key = "1",          mods = "LEADER",       action = act { ActivateTab = 0 } },
{ key = "2",          mods = "LEADER",       action = act { ActivateTab = 1 } },
{ key = "3",          mods = "LEADER",       action = act { ActivateTab = 2 } },
{ key = "4",          mods = "LEADER",       action = act { ActivateTab = 3 } },
{ key = "5",          mods = "LEADER",       action = act { ActivateTab = 4 } },
{ key = "6",          mods = "LEADER",       action = act { ActivateTab = 5 } },
{ key = "7",          mods = "LEADER",       action = act { ActivateTab = 6 } },
{ key = "8",          mods = "LEADER",       action = act { ActivateTab = 7 } },
{ key = "9",          mods = "LEADER",       action = act { ActivateTab = 8 } },
{ key = "0",          mods = "LEADER",       action = act { ActivateTab = -1 } },

create_keybind("ActivateTab", "ALT", "1", 0),
create_keybind("ActivateTab", "ALT", "2", 1),
create_keybind("ActivateTab", "ALT", "3", 2),
create_keybind("ActivateTab", "ALT", "4", 3),
create_keybind("ActivateTab", "ALT", "5", 4),
create_keybind("ActivateTab", "ALT", "6", 5),
create_keybind("ActivateTab", "ALT", "7", 6),
create_keybind("ActivateTab", "ALT", "8", 7),
create_keybind("ActivateTab", "ALT", "9", 8),
create_keybind("ActivateTab", "ALT", "0", -1),

{ key = "1",      mods = "ALT|CTRL",   action = act { ActivateTab = 0 } },
{ key = "2",      mods = "ALT|CTRL",   action = act { ActivateTab = 1 } },
{ key = "3",      mods = "ALT|CTRL",   action = act { ActivateTab = 2 } },
{ key = "4",      mods = "ALT|CTRL",   action = act { ActivateTab = 3 } },
{ key = "5",      mods = "ALT|CTRL",   action = act { ActivateTab = 4 } },
{ key = "6",      mods = "ALT|CTRL",   action = act { ActivateTab = 5 } },
{ key = "7",      mods = "ALT|CTRL",   action = act { ActivateTab = 6 } },
{ key = "8",      mods = "ALT|CTRL",   action = act { ActivateTab = 7 } },
{ key = "9",      mods = "ALT|CTRL",   action = act { ActivateTab = 8 } },
{ key = "0",      mods = "ALT|CTRL",   action = act { ActivateTab = -1 } },

標籤移動

{ key = "R",         mods = "LEADER",       action = act.ActivateKeyTable { name = "move_tab", one_shot = false, timeout_milliseconds = 5000 } },

create_keybind("MoveTabRelative", "SHIFT|ALT", "{", -1),
create_keybind("MoveTabRelative", "SHIFT|ALT", "}", 1),

{ key = "UpArrow",   mods = "SHIFT|CTRL",   action = act.MoveTabRelative(-1) },
{ key = "DownArrow", mods = "SHIFT|CTRL",   action = act.MoveTabRelative(1) },

{ key = "P",         mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(-1)) },
{ key = "N",         mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(1)) },

滑鼠繫結

沿用 windows 終端的習慣是：

{
event = { Down = { streak = 1, button = 'Right' } },
mods = "NONE",
action = wezterm.action_callback(function(window, pane)
	local has_selection = window:get_selection_text_for_pane(pane) ~= ""
	if has_selection then
		window:perform_action(act.CopyTo("ClipboardAndPrimarySelection"), pane)
		window:perform_action(act.ClearSelection, pane)
	else
		window:perform_action(act({
			PasteFrom = "Clipboard"
		}), pane)
	end
end)
},

這個配置使得滑鼠右鍵在選擇了文字時複製，沒有選擇時貼上。

完整配置

keymap.lua

local wezterm = require("wezterm")
local act = wezterm.action

-- key bindings
local leader = {
	-- win + alt + space
	key = 'Space',
	mods = 'SUPER|ALT',
	timeout_milliseconds = math.maxinteger
}


local key_tables = {
	resize_pane = {
		{ key = 'LeftArrow',  action = act.AdjustPaneSize { 'Left', 1 } },
		{ key = 'h',          action = act.AdjustPaneSize { 'Left', 1 } },
		{ key = 'H',          action = act.AdjustPaneSize { 'Left', 10 } },

		{ key = 'RightArrow', action = act.AdjustPaneSize { 'Right', 1 } },
		{ key = 'l',          action = act.AdjustPaneSize { 'Right', 1 } },
		{ key = 'L',          action = act.AdjustPaneSize { 'Right', 10 } },

		{ key = 'UpArrow',    action = act.AdjustPaneSize { 'Up', 1 } },
		{ key = 'k',          action = act.AdjustPaneSize { 'Up', 1 } },
		{ key = 'K',          action = act.AdjustPaneSize { 'Up', 10 } },

		{ key = 'DownArrow',  action = act.AdjustPaneSize { 'Down', 1 } },
		{ key = 'j',          action = act.AdjustPaneSize { 'Down', 1 } },
		{ key = 'J',          action = act.AdjustPaneSize { 'Down', 10 } },

		{ key = 'Escape',     action = 'PopKeyTable' },
		{ key = 'q',          action = 'PopKeyTable' },
		{ key = 'Q',          action = 'PopKeyTable' }
	},
	activate_pane = {
		{ key = 'LeftArrow',  action = act.ActivatePaneDirection 'Left' },
		{ key = 'h',          action = act.ActivatePaneDirection 'Left' },

		{ key = 'RightArrow', action = act.ActivatePaneDirection 'Right' },
		{ key = 'l',          action = act.ActivatePaneDirection 'Right' },

		{ key = 'UpArrow',    action = act.ActivatePaneDirection 'Up' },
		{ key = 'k',          action = act.ActivatePaneDirection 'Up' },

		{ key = 'DownArrow',  action = act.ActivatePaneDirection 'Down' },
		{ key = 'j',          action = act.ActivatePaneDirection 'Down' },

		{ key = 'Escape',     action = 'PopKeyTable' },
		{ key = 'q',          action = 'PopKeyTable' },
		{ key = 'Q',          action = 'PopKeyTable' }
	},
	move_tab = {
		{ key = 'N',          action = act.MoveTabRelative(1) },
		{ key = 'P',          action = act.MoveTabRelative(-1) },

		{ key = 'n',          action = act.MoveTabRelative(1) },
		{ key = 'p',          action = act.MoveTabRelative(-1) },

		{ key = 'h',          action = act.MoveTabRelative(-1) },
		{ key = 'j',          action = act.MoveTabRelative(1) },
		{ key = 'k',          action = act.MoveTabRelative(-1) },
		{ key = 'l',          action = act.MoveTabRelative(1) },

		{ key = 'LeftArrow',  action = act.MoveTabRelative(-1) },
		{ key = 'RightArrow', action = act.MoveTabRelative(1) },
		{ key = 'UpArrow',    action = act.MoveTabRelative(-1) },
		{ key = 'DownArrow',  action = act.MoveTabRelative(1) },

		{ key = 'Escape',     action = 'PopKeyTable' },
		{ key = 'q',          action = 'PopKeyTable' },
		{ key = 'Q',          action = 'PopKeyTable' }
	},
	activate_tab = {
		{ key = 'N',          action = act.ActivateTab(-1) },
		{ key = 'P',          action = act.ActivateTab(0) },

		{ key = 'n',          action = act.ActivateTabRelative(1) },
		{ key = 'p',          action = act.ActivateTabRelative(-1) },

		{ key = 'h',          action = act.ActivateTabRelative(-1) },
		{ key = 'j',          action = act.ActivateTabRelative(1) },
		{ key = 'k',          action = act.ActivateTabRelative(-1) },
		{ key = 'l',          action = act.ActivateTabRelative(1) },

		{ key = 'LeftArrow',  action = act.ActivateTabRelative(-1) },
		{ key = 'RightArrow', action = act.ActivateTabRelative(1) },
		{ key = 'UpArrow',    action = act.ActivateTabRelative(-1) },
		{ key = 'DownArrow',  action = act.ActivateTabRelative(1) },

		{ key = 'Escape',     action = 'PopKeyTable' },
		{ key = 'q',          action = 'PopKeyTable' },
		{ key = 'Q',          action = 'PopKeyTable' }
	}
}

-- Helper functions
--------------------------------------------------------------------------------
-- enable actions for activating and resizing panes similar to tmux.
local function activate_pane_with_dir(dir)
	return function(win, pane)
		win:perform_action(act.ActivatePaneDirection(dir), pane)
		win:perform_action(act.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 600 },
			pane)
	end
end

local function resize_pane_with_dir(dir)
	return function(win, pane)
		win:perform_action(act.AdjustPaneSize { dir, 10 }, pane)
		win:perform_action(act.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 600 },
			pane)
	end
end

local function activate_tab_with_dir(dir)
	return function(win, pane)
		win:perform_action(act.ActivateTabRelative(dir), pane)
		win:perform_action(act.ActivateKeyTable { name = 'activate_tab', one_shot = false, timeout_milliseconds = 600 },
			pane)
	end
end

local function move_tab_with_dir(dir)
	return function(win, pane)
		win:perform_action(act.MoveTabRelative(dir), pane)
		win:perform_action(act.ActivateKeyTable { name = 'move_tab', one_shot = false, timeout_milliseconds = 600 },
			pane)
	end
end

local function smart_split_callback(window, pane)
	local dim = pane:get_dimensions()
	if dim.pixel_height > dim.pixel_width then
		window:perform_action(act.SplitVertical({ domain = "CurrentPaneDomain" }), pane)
	else
		window:perform_action(act.SplitHorizontal({ domain = "CurrentPaneDomain" }), pane)
	end
end

local function is_nvim_or_tmux_or_zellij(pane)
	local foreground_process = pane:get_foreground_process_name() or ""
	local user_vars = pane:get_user_vars()
	if user_vars.IS_TMUX == "true" or foreground_process:find("tmux") then
		return true
	end
	if user_vars.IS_ZELLIJ == "true" or foreground_process:find("zellij") then
		return true
	end
	if user_vars.IS_NVIM == "true" or foreground_process:find("n?vim") then
		return true
	end
	if foreground_process:find("kitten") then
		return true
	end
	return false
end

local function activate_pane_and_tab(window, pane, dir)
	local tab = window:mux_window():active_tab()
	local directions = {
		Left = { pane_check = "Left", tab_offset = -1 },
		Right = { pane_check = "Right", tab_offset = 1 }
	}

	local dir_config = directions[dir]
	local action = tab:get_pane_direction(dir_config.pane_check) ~= nil
			and wezterm.action.ActivatePaneDirection(dir_config.pane_check)
			or wezterm.action.ActivateTabRelative(dir_config.tab_offset)

	window:perform_action(action, pane)
end

local ACTION_HANDLERS = {
	AdjustPaneSize = function(win, pane, dir)
		return { AdjustPaneSize = { dir, 5 } }
	end,
	ActivatePaneDirection = function(win, pane, dir)
		local panes = pane:tab():panes_with_info()
		local is_zoomed = false
		for _, p in ipairs(panes) do
			if p.is_zoomed then
				is_zoomed = true
				break
			end
		end
		if is_zoomed then
			dir = (dir == "Up" or dir == "Right") and "Next" or "Prev"
		end
		if dir == "Left" or dir == "Right" then
			activate_pane_and_tab(win, pane, dir)
			return
		end
		win:perform_action({ ActivatePaneDirection = dir }, pane)
		win:perform_action({ SetPaneZoomState = is_zoomed }, pane)
	end,
	ActivateTab = function(win, pane, dir)
		return wezterm.action.ActivateTab(dir)
	end,
	ActivateTabRelative = function(win, pane, dir)
		return wezterm.action.ActivateTabRelative(dir)
	end,
	MoveTabRelative = function(win, pane, dir)
		return wezterm.action.MoveTabRelative(dir)
	end,
	SpawnTab = function(win, pane, dir)
		return wezterm.action.SpawnTab(dir)
	end,
	CloseCurrentTab = function()
		return wezterm.action.CloseCurrentTab { confirm = true }
	end,
	CloseCurrentPane = function()
		return wezterm.action.CloseCurrentPane { confirm = true }
	end,
	smart_split = smart_split_callback,
}

local function create_keybind(action_str, mods, key, dir)
	return {
		key = key,
		mods = mods,
		action = wezterm.action_callback(function(win, pane)
			if is_nvim_or_tmux_or_zellij(pane) then
				win:perform_action({
					SendKey = { key = key, mods = mods }
				}, pane)
				return
			end
			local handler = ACTION_HANDLERS[action_str]
			if handler then
				local result = handler(win, pane, dir)
				if result then
					win:perform_action(result, pane)
				end
			else
				win:perform_action({
					SendKey = { key = key, mods = mods }
				}, pane)
			end
		end)
	}
end
--------------------------------------------------------------------------------

local keys = {
	-- {key = "s",mods = "LEADER|CTRL",action = wezterm.action {SendString = "\x01"}},

	-- Normal
	create_keybind("SpawnTab", "ALT", "t", "CurrentPaneDomain"),
	create_keybind("smart_split", "ALT", "n"),
	create_keybind("CloseCurrentTab", "ALT", "q"),
	create_keybind("CloseCurrentPane", "ALT", "x"),

	{ key = "T",      mods = "SHIFT|CTRL",   action = act { SpawnTab = "CurrentPaneDomain" } },
	{ key = "W",      mods = "SHIFT|CTRL",   action = act { CloseCurrentTab = { confirm = true } } },
	{ key = "V",      mods = "SHIFT|CTRL",   action = act { PasteFrom = "Clipboard" } },
	{ key = "C",      mods = "SHIFT|CTRL",   action = act { CopyTo = "Clipboard" } },
	{ key = "Tab",    mods = "CTRL",         action = act.ActivateTabRelative(1) },
	{ key = "Tab",    mods = "SHIFT|CTRL",   action = act.ActivateTabRelative(-1) },
	{ key = "Return", mods = "ALT",          action = "ToggleFullScreen" },
	{ key = "F11",    mods = "",             action = "ToggleFullScreen" },

	{ key = "c",      mods = "LEADER",       action = act { SpawnTab = "CurrentPaneDomain" } },
	{ key = "&",      mods = "LEADER",       action = act { CloseCurrentTab = { confirm = false } } },
	{ key = "q",      mods = "LEADER",       action = act { CloseCurrentTab = { confirm = false } } },
	{ key = "x",      mods = "LEADER",       action = act { CloseCurrentPane = { confirm = false } } },
	{ key = 's',      mods = 'LEADER',       action = act.PaneSelect },
	{ key = 'S',      mods = 'SHIFT|LEADER', action = act.PaneSelect { mode = 'SwapWithActive' } },
	{ key = 'w',      mods = 'LEADER',       action = act.ShowTabNavigator },
	{ key = "k",      mods = "LEADER",       action = act.RotatePanes "Clockwise" },

	-- Pane navigation
	create_keybind("ActivatePaneDirection", "ALT", "h", "Left"),
	create_keybind("ActivatePaneDirection", "ALT", "j", "Down"),
	create_keybind("ActivatePaneDirection", "ALT", "k", "Up"),
	create_keybind("ActivatePaneDirection", "ALT", "l", "Right"),

	create_keybind("ActivatePaneDirection", "ALT", "[", "Prev"),
	create_keybind("ActivatePaneDirection", "ALT", "]", "Next"),

	{ key = "a",          mods = "LEADER",   action = act.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 5000 } },

	{ key = 'h',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Left")) },
	{ key = 'j',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Down")) },
	{ key = 'k',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Up")) },
	{ key = 'l',          mods = 'LEADER',   action = wezterm.action_callback(activate_pane_with_dir("Right")) },

	{ key = "UpArrow",    mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Up")) },
	{ key = "DownArrow",  mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Down")) },
	{ key = "LeftArrow",  mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Left")) },
	{ key = "RightArrow", mods = "LEADER",   action = wezterm.action_callback(activate_pane_with_dir("Right")) },

	{ key = "h",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } },
	{ key = "j",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } },
	{ key = "k",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } },
	{ key = "l",          mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } },

	{ key = "UpArrow",    mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } },
	{ key = "DownArrow",  mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } },
	{ key = "LeftArrow",  mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } },
	{ key = "RightArrow", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } },

	-- Pane resize
	create_keybind("AdjustPaneSize", "ALT", "LeftArrow", "Left"),
	create_keybind("AdjustPaneSize", "ALT", "RightArrow", "Right"),
	create_keybind("AdjustPaneSize", "ALT", "UpArrow", "Up"),
	create_keybind("AdjustPaneSize", "ALT", "DownArrow", "Down"),

	{ key = 'r',          mods = 'LEADER',         action = act.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 5000 } },

	-- use Multiple keybinds fails because of async, so use action_callback
	{ key = 'H',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Left")) },
	{ key = 'J',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Down")) },
	{ key = 'K',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Up")) },
	{ key = 'L',          mods = 'SHIFT|LEADER',   action = wezterm.action_callback(resize_pane_with_dir("Right")) },

	{ key = "UpArrow",    mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Up")) },
	{ key = "DownArrow",  mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Down")) },
	{ key = "LeftArrow",  mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Left")) },
	{ key = "RightArrow", mods = "SHIFT|LEADER",   action = wezterm.action_callback(resize_pane_with_dir("Right")) },

	{ key = "h",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 1 } } },
	{ key = "l",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 1 } } },
	{ key = "k",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 1 } } },
	{ key = "j",          mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 1 } } },

	{ key = "UpArrow",    mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 1 } } },
	{ key = "DownArrow",  mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 1 } } },
	{ key = "LeftArrow",  mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 1 } } },
	{ key = "RightArrow", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 1 } } },

	-- Pane splitting
	{ key = "Enter",      mods = "LEADER",         action = wezterm.action_callback(smart_split_callback) },
	{ key = "Enter",      mods = "ALT|CTRL",       action = wezterm.action_callback(smart_split_callback) },
	{ key = "Enter",      mods = "SHIFT|CTRL",     action = wezterm.action_callback(smart_split_callback) },
	{ key = "-",          mods = "ALT|CTRL",       action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },
	{ key = "\\",         mods = "ALT|CTRL",       action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },
	{ key = "-",          mods = "LEADER",         action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },
	{ key = "\\",         mods = "LEADER",         action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },
	{ key = "_",          mods = "SHIFT|CTRL",     action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },
	{ key = "|",          mods = "SHIFT|CTRL",     action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },
	{ key = "m",          mods = "LEADER",         action = "TogglePaneZoomState" },

	-- Tab navigation
	create_keybind("ActivateTabRelative", "ALT|CTRL", "[", -1),
	create_keybind("ActivateTabRelative", "ALT|CTRL", "]", 1),

	{ key = "A",          mods = "SHIFT|LEADER", action = act.ActivateKeyTable { name = "activate_tab", one_shot = false, timeout_milliseconds = 5000 } },

	{ key = "LeftArrow",  mods = "SHIFT|CTRL",   action = act.ActivateTabRelative(-1) },
	{ key = "RightArrow", mods = "SHIFT|CTRL",   action = act.ActivateTabRelative(1) },

	{ key = "n",          mods = "LEADER",       action = wezterm.action_callback(activate_tab_with_dir(1)) },
	{ key = "p",          mods = "LEADER",       action = wezterm.action_callback(activate_tab_with_dir(-1)) },

	{ key = "1",          mods = "LEADER",       action = act { ActivateTab = 0 } },
	{ key = "2",          mods = "LEADER",       action = act { ActivateTab = 1 } },
	{ key = "3",          mods = "LEADER",       action = act { ActivateTab = 2 } },
	{ key = "4",          mods = "LEADER",       action = act { ActivateTab = 3 } },
	{ key = "5",          mods = "LEADER",       action = act { ActivateTab = 4 } },
	{ key = "6",          mods = "LEADER",       action = act { ActivateTab = 5 } },
	{ key = "7",          mods = "LEADER",       action = act { ActivateTab = 6 } },
	{ key = "8",          mods = "LEADER",       action = act { ActivateTab = 7 } },
	{ key = "9",          mods = "LEADER",       action = act { ActivateTab = 8 } },
	{ key = "0",          mods = "LEADER",       action = act { ActivateTab = -1 } },

	create_keybind("ActivateTab", "ALT", "1", 0),
	create_keybind("ActivateTab", "ALT", "2", 1),
	create_keybind("ActivateTab", "ALT", "3", 2),
	create_keybind("ActivateTab", "ALT", "4", 3),
	create_keybind("ActivateTab", "ALT", "5", 4),
	create_keybind("ActivateTab", "ALT", "6", 5),
	create_keybind("ActivateTab", "ALT", "7", 6),
	create_keybind("ActivateTab", "ALT", "8", 7),
	create_keybind("ActivateTab", "ALT", "9", 8),
	create_keybind("ActivateTab", "ALT", "0", -1),

	{ key = "1", mods = "ALT|CTRL", action = act { ActivateTab = 0 } },
	{ key = "2", mods = "ALT|CTRL", action = act { ActivateTab = 1 } },
	{ key = "3", mods = "ALT|CTRL", action = act { ActivateTab = 2 } },
	{ key = "4", mods = "ALT|CTRL", action = act { ActivateTab = 3 } },
	{ key = "5", mods = "ALT|CTRL", action = act { ActivateTab = 4 } },
	{ key = "6", mods = "ALT|CTRL", action = act { ActivateTab = 5 } },
	{ key = "7", mods = "ALT|CTRL", action = act { ActivateTab = 6 } },
	{ key = "8", mods = "ALT|CTRL", action = act { ActivateTab = 7 } },
	{ key = "9", mods = "ALT|CTRL", action = act { ActivateTab = 8 } },
	{ key = "0", mods = "ALT|CTRL", action = act { ActivateTab = -1 } },

	-- Tab movement
	{ key = "R", mods = "LEADER",   action = act.ActivateKeyTable { name = "move_tab", one_shot = false, timeout_milliseconds = 5000 } },
	create_keybind("MoveTabRelative", "SHIFT|ALT", "{", -1),
	create_keybind("MoveTabRelative", "SHIFT|ALT", "}", 1),

	{ key = "UpArrow",   mods = "SHIFT|CTRL",   action = act.MoveTabRelative(-1) },
	{ key = "DownArrow", mods = "SHIFT|CTRL",   action = act.MoveTabRelative(1) },

	{ key = "P",         mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(-1)) },
	{ key = "N",         mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(1)) },


	-- other
	{ key = 'S',         mods = 'SHIFT|ALT',    action = act.ShowLauncherArgs { flags = 'FUZZY|TABS|LAUNCH_MENU_ITEMS' }, },
	{ key = 'F9',        mods = 'ALT',          action = act.ShowTabNavigator },
	{ key = 'Space',     mods = 'LEADER',       action = act.ShowLauncher },
	{ key = '/',         mods = 'LEADER',       action = act.ActivateCopyMode },

}

local mouse_bindings = {
	{
		-- right clink select (not wezterm copy mode),copy, and if don't select anything, paste
		-- https://github.com/wez/wezterm/discussions/3541#discussioncomment-5633570
		event = { Down = { streak = 1, button = 'Right' } },
		mods = "NONE",
		action = wezterm.action_callback(function(window, pane)
			local has_selection = window:get_selection_text_for_pane(pane) ~= ""
			if has_selection then
				window:perform_action(act.CopyTo("ClipboardAndPrimarySelection"), pane)
				window:perform_action(act.ClearSelection, pane)
			else
				window:perform_action(act({
					PasteFrom = "Clipboard"
				}), pane)
			end
		end)
	},
	-- Change the default click behavior so that it only selects
	-- text and doesn't open hyperlinks
	{
		event = { Up = { streak = 1, button = 'Left' } },
		mods = 'NONE',
		-- action = act.CompleteSelection('ClipboardAndPrimarySelection'),
		action = act.Nop
	},
	-- and make CTRL-Click open hyperlinks
	{
		event = { Up = { streak = 1, button = 'Left' } },
		mods = 'CTRL',
		action = act.OpenLinkAtMouseCursor,
	},
}

return {
	leader = leader,
	key_tables = key_tables,
	keys = keys,
	mouse_bindings = mouse_bindings,
}

wezterm.lua

local config = {
	check_for_updates = false,
	enable_wayland = false,
	front_end = "WebGpu",
	max_fps = 165,
	enable_kitty_keyboard = true,
	disable_default_key_bindings = true,
}

config.leader = keymap_config.leader
config.key_tables = keymap_config.key_tables
config.keys = keymap_config.keys
config.mouse_bindings = keymap_config.mouse_bindings
config.launch_menu = launch_menu

return config

GridView自定義列資料繫結，和自定義頒功能
2011-11-15
View
繫結自定義事件
2018-11-14
事件
this 繫結解析
2019-03-18
080 元件自定義事件-繫結
2024-10-29
元件事件
深入理解 C++ 的動態繫結和靜態繫結
2016-11-02
C++
IOC容器的繫結解析過程(繫結單例)
2020-09-23
單例
1.22 JQuery5：繫結自定義事件
2018-11-14
jQuery事件
WPF快速指導4：資料繫結之繫結方向與自定義轉換器
2017-05-26
C++的動態繫結和靜態繫結
2019-05-10
C++
Laravel 路由的隱式繫結和顯式繫結
2017-11-17
Laravel路由
@ConfigurationProperties實現自定義配置繫結
2021-08-20
Laravel 多鍵路由繫結
2019-09-25
Laravel路由
【阿不】深入ASP.NET資料繫結（下）—多樣的繫結方式
2008-07-16
ASP.NET
動態繫結和靜態繫結的簡單理解
2014-12-21
【asp.net core】自定義模型繫結及其驗證
2023-05-09
ASP.NET模型
java繼承-靜態繫結和動態繫結
2018-02-07
Java繼承
emacs按鍵繫結詳解
2020-11-25
Mac
簡單資料繫結和複雜資料繫結
2011-11-21
ROS指令碼ip-mac繫結批次繫結ip和mac
2021-04-28
ROS指令碼Mac
【阿不】深入ASP.NET資料繫結（中）—資料雙向繫結機理
2008-07-16
ASP.NET
java中的靜態繫結與動態繫結
2024-11-13
Java
理解靜態繫結與動態繫結
2019-09-26
[BUG反饋]新增分類時無法繫結自定義模型
2019-05-11
模型
直播系統平臺搭建，DataBinding自定義雙向繫結
2021-11-01
深入理解 js this 繫結 ( 無需死記硬背，尾部有總結和麵試題解析 )
2019-02-16
JS
繫結事件
2008-03-13
事件
事件繫結
2024-07-17
事件
SAP OData V4 模型的絕對繫結和相對繫結模式
2022-04-29
模型模式
Android | 教你如何開發一鍵銀行卡繫結功能
2020-05-07
Android
vue3+TS 自定義指令：長按觸發繫結的函式
2022-12-29
Vue函式
Maven自定義繫結外掛目標：建立專案的原始碼jar
2017-01-05
Maven原始碼JAR
關於繫結變數的SQL繫結什麼值
2016-01-27
變數SQL
Javascrip—關於this繫結機制的解析（12）
2018-10-19
Java
SSL證書繫結域名還是繫結IP？
2022-08-23
C++ — 靜態繫結與動態繫結
2017-10-10
C++
dataGridView繫結Dictionary |Dictionary繫結到DataGridView
2013-10-14
View
JavaScript 的 this 指向和繫結詳解
2020-09-07
JavaScript
模板語法之--強制資料繫結和繫結事件監聽
2020-11-06
事件