Scrolling that behaves.
This plugins offers Vim-like scroll commands whilst fixing some of the current keyboard scrolling bummers:
- Preserves folds
- Won't get stuck at folds
- Respects scrollOff
- Keeps the cursor moving when the document boundary is reached
Basically, it aims to make scrolling behave just like it's expected from it.
You get three scrolling motions.
| Scroller | Default Keymaps |
|---|---|
| Armin | ️️⬆ Ctrl+Down️ |
| ⬇ Ctrl+Up | |
| Berthold | ⬆ Ctrl+PageUp |
| ⬇ Ctrl+PageDown | |
| Christa | ⬆ PageUp |
| ⬇ PageDown |
Links to a quick and dirty video example using german-scroll in VSCodium in combination with VSCodeVim.
Configure the scrolling distance in your settings.json.
Possible values are <number> | "halfPage" | "page".
Default settings:
"germanScroll.armin": 5
"germanScroll.berthold": "halfPage"
"germanScroll.christa": "page"{
"command": "germanScroll.arminUp",
"key": "ctrl+y",
"mac": "cmd+y",
"when": "vim.active && editorTextFocus && vim.mode != 'Insert'"
},
{
"command": "germanScroll.arminDown",
"key": "ctrl+e",
"mac": "cmd+e",
"when": "vim.active && editorTextFocus && vim.mode != 'Insert'"
},
{
"command": "germanScroll.bertholdUp",
"key": "ctrl+u",
"mac": "cmd+u",
"when": "vim.active && editorTextFocus && vim.mode != 'Insert'"
},
{
"command": "germanScroll.bertholdDown",
"key": "ctrl+d",
"mac": "cmd+d",
"when": "vim.active && editorTextFocus && vim.mode != 'Insert'"
},
{
"command": "germanScroll.christaUp",
"key": "ctrl+b",
"mac": "cmd+b",
"when": "vim.active && editorTextFocus && vim.mode != 'Insert'"
},
{
"command": "germanScroll.christaDown",
"key": "ctrl+f",
"mac": "cmd+f",
"when": "vim.active && editorTextFocus && vim.mode != 'Insert'"
},After using this extension for a while and being happy with its behavior, it should make its way into the public domain. Since it's still pretty fresh out of the oven and not many eyes have been on it yet, there may be scenarios where the scrolling behaves unexpectedly.
If you notice any of these issues, feel free to open an issue or submit a PR.
And of course showing some love and leaving a star on the repo or rating the extension always helps ❤️.
*Especially in today's times it's hard to always be politically correct. Additionally the high interconnectedness of people with different cultural backgrounds makes it impossible to prevent misunderstandings sometimes. Therefore I want to add the info that the plugins name and theme is taking the mickey out of our(being from germany myself) german correctness and not a nationalistic discrimination of others.
Nothing that would break something but some small things could be observed:
- Scrolling inconsistencies may occur:
- During fast scrolling (e.g., pressing and holding the key) with the "smooth scrolling" setting enabled.
- During scrolling actions between folded sections.
- Selection becomes invisible when scrolling in VisualMode beyond the currently visible range (it reappears when moving the cursor after scrolling).
- There should probably be additional settings that allow the user to disable behaviors such as continuing cursor movement when the document boundary is reached.