mirror of
https://github.com/wez/wezterm.git
synced 2024-12-18 19:01:36 +03:00
63 lines
2.0 KiB
Markdown
63 lines
2.0 KiB
Markdown
# QuickSelectArgs
|
|
|
|
*Since: nightly builds only*
|
|
|
|
Activates [Quick Select Mode](../../../quickselect.md) but with the option
|
|
to override the global configuration.
|
|
|
|
This example shows how to pop up a quick select that is scoped solely to
|
|
a very basic http regex; it will only match those regexes regardless of
|
|
the default or the [quick_select_patterns](../config/quick_select_patterns.md)
|
|
configuration:
|
|
|
|
```lua
|
|
local wezterm = require 'wezterm'
|
|
|
|
return {
|
|
keys = {
|
|
{key="P", mods="CTRL",
|
|
action=wezterm.action{QuickSelectArgs={
|
|
patterns={
|
|
"https?://\\S+"
|
|
},
|
|
}}
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
The `QuickSelectArgs` struct allows for the following fields:
|
|
|
|
* `patterns` - if present, completely overrides the normal set of patterns and uses only the patterns specified
|
|
* `alphabet` - if present, this alphabet is used instead of [quick_select_alphabet](../config/quick_select_alphabet.md)
|
|
* `action` - if present, this key assignment action is performed as if by [window:perform_action](../window/perform_action.md) when an item is selected. The normal clipboard action is NOT performed in this case.
|
|
* `label` - if present, replaces the string `"copy"` that is shown at the bottom of the overlay; you can use this to indicate which action will happen if you are using `action`.
|
|
|
|
Here's an example that shows how to trigger some lua code to operate on the
|
|
quick-selected text, instead of copying it to the clipboard. Here, we open
|
|
the selected URL using the web browser:
|
|
|
|
```lua
|
|
local wezterm = require 'wezterm'
|
|
|
|
return {
|
|
keys = {
|
|
{key="P", mods="CTRL",
|
|
action=wezterm.action{QuickSelectArgs={
|
|
label = "open url",
|
|
patterns={
|
|
"https?://\\S+"
|
|
},
|
|
action = wezterm.action_callback(function(window, pane)
|
|
local url = window:get_selection_text_for_pane(pane)
|
|
wezterm.log_info("opening: " .. url)
|
|
wezterm.open_with(url)
|
|
end)
|
|
}}
|
|
},
|
|
},
|
|
}
|
|
```
|
|
|
|
See also [wezterm.open_with](../wezterm/open_with.md).
|