docs(config): document hint.text-click
- commit
- 545c2bfb18712aa3b04d5f404b5f9a2be3848f3e
- author
- brice · · 2026-10-19 13:48 UTC
- parent
- c426ca6
- signature
- GPG Verified
CD88F9E564E0102646FB6077A1A07C7C7C3E349D· arch-gpg Verified for the committer email
1 file · +5 -1
M docs/config.md +5 -1
| @@ -56,6 +56,7 @@ See [examples/config](../examples/config) for every key with its default. | |||
| 56 | 56 | | `focus.flash-duration` | `200ms` | Fade duration, `50ms` to `1s`; not scaled by `animations.speed` | | |
| 57 | 57 | | `focus.flash-color` | `border.active` | Flash color `#rrggbb`; empty uses `border.active` | | |
| 58 | 58 | | `hint.targets` | `clickable` | What [hint mode](#hint-mode) labels: `clickable` (links, URLs and buttons) or `links` (links and URLs only) | | |
| 59 | + | | `hint.text-click` | `ctrl+shift` | Modifiers held for clicks on links found by OCR (terminals open links on a modified click); `none` sends a plain click | | |
| 59 | 60 | | `hint.size` | `auto` | Label text size in logical pixels (positive number), or `auto` for screen pixel density | | |
| 60 | 61 | | `hint.background` | empty | Label background (`#rrggbb`); empty uses `border.active` | | |
| 61 | 62 | | `hint.foreground` | empty | Label text (`#rrggbb`); empty chooses a contrasting colour | | |
| @@ -308,7 +309,10 @@ click its target; BackSpace erases a letter, Escape cancels. No bind is set | |||
| 308 | 309 | by default; for example `bind.cmd+g = hint`. | |
| 309 | 310 | ||
| 310 | 311 | Labels use the `border.active` colour with a contrasting text colour, and | |
| 311 | - | their size follows the screen's pixel density. | |
| 312 | + | their size follows the screen's pixel density. Each label sits just outside | |
| 313 | + | the top-left corner of its target. Links found by OCR (terminal text) are | |
| 314 | + | clicked with the `hint.text-click` modifiers held, which is how terminals open | |
| 315 | + | a link; accessibility targets get a plain click. | |
| 312 | 316 | ||
| 313 | 317 | ### Where targets come from | |
| 314 | 318 | ||
| @@ -56,6 +56,7 @@ See [examples/config](../examples/config) for every key with its default. | |||||
| 56 | | `focus.flash-duration` | `200ms` | Fade duration, `50ms` to `1s`; not scaled by `animations.speed` | | 56 | | `focus.flash-duration` | `200ms` | Fade duration, `50ms` to `1s`; not scaled by `animations.speed` | | ||
| 57 | | `focus.flash-color` | `border.active` | Flash color `#rrggbb`; empty uses `border.active` | | 57 | | `focus.flash-color` | `border.active` | Flash color `#rrggbb`; empty uses `border.active` | | ||
| 58 | | `hint.targets` | `clickable` | What [hint mode](#hint-mode) labels: `clickable` (links, URLs and buttons) or `links` (links and URLs only) | | 58 | | `hint.targets` | `clickable` | What [hint mode](#hint-mode) labels: `clickable` (links, URLs and buttons) or `links` (links and URLs only) | | ||
| 59 | + | | `hint.text-click` | `ctrl+shift` | Modifiers held for clicks on links found by OCR (terminals open links on a modified click); `none` sends a plain click | | |||
| 59 | | `hint.size` | `auto` | Label text size in logical pixels (positive number), or `auto` for screen pixel density | | 60 | | `hint.size` | `auto` | Label text size in logical pixels (positive number), or `auto` for screen pixel density | | ||
| 60 | | `hint.background` | empty | Label background (`#rrggbb`); empty uses `border.active` | | 61 | | `hint.background` | empty | Label background (`#rrggbb`); empty uses `border.active` | | ||
| 61 | | `hint.foreground` | empty | Label text (`#rrggbb`); empty chooses a contrasting colour | | 62 | | `hint.foreground` | empty | Label text (`#rrggbb`); empty chooses a contrasting colour | | ||
| @@ -308,7 +309,10 @@ click its target; BackSpace erases a letter, Escape cancels. No bind is set | |||||
| 308 | by default; for example `bind.cmd+g = hint`. | 309 | by default; for example `bind.cmd+g = hint`. | ||
| 309 | 310 | ||||
| 310 | Labels use the `border.active` colour with a contrasting text colour, and | 311 | Labels use the `border.active` colour with a contrasting text colour, and | ||
| 311 | - | their size follows the screen's pixel density. | 312 | + | their size follows the screen's pixel density. Each label sits just outside |
| 313 | + | the top-left corner of its target. Links found by OCR (terminal text) are | |||
| 314 | + | clicked with the `hint.text-click` modifiers held, which is how terminals open | |||
| 315 | + | a link; accessibility targets get a plain click. | |||
| 312 | 316 | ||||
| 313 | ### Where targets come from | 317 | ### Where targets come from | ||
| 314 | 318 | ||||