wiki: Document the DnD edge view scroll gesture and config

This commit is contained in:
Ivan Molodetskikh
2025-02-16 09:41:50 +03:00
parent f2b1fc66f2
commit 5c0468d469
3 changed files with 55 additions and 0 deletions
+43
View File
@@ -0,0 +1,43 @@
### Overview
<sup>Since: next release</sup>
The `gestures` config section contains gesture settings.
For an overview of all niri gestures, see the [Gestures](./Gestures.md) wiki page.
Here's a quick glance at the available settings along with their default values.
```kdl
gestures {
dnd-edge-view-scroll {
trigger-width 30
delay-ms 50
max-speed 1500
}
}
```
### `dnd-edge-view-scroll`
Scroll the tiling view when moving the mouse cursor against a monitor edge during drag-and-drop (DnD).
Also works on a touchscreen.
This will work for regular drag-and-drop (e.g. dragging a file from a file manager), and for window interactive move when targeting the tiling layout.
The options are:
- `trigger-width`: size of the area near the monitor edge that will trigger the scrolling, in logical pixels.
- `delay-ms`: delay in milliseconds before the scrolling starts.
Avoids unwanted scrolling when dragging things across monitors.
- `max-speed`: maximum scrolling speed in logical pixels per second.
The scrolling speed increases linearly as you move your mouse cursor from `trigger-width` to the very edge of the monitor.
```kdl
gestures {
// Increase the trigger area and maximum speed.
dnd-edge-view-scroll {
trigger-width 100
max-speed 3000
}
}
```
+11
View File
@@ -2,6 +2,8 @@
There are several gestures in niri.
Also see the [gestures configuration](./Configuration:-Gestures.md) wiki page.
### Mouse
#### Interactive Move
@@ -57,3 +59,12 @@ Switch workspaces with three-finger vertical swipes.
#### Horizontal View Movement
Move the view horizontally with three-finger horizontal swipes.
### All Pointing Devices
#### Drag-and-Drop Edge View Scroll
<sup>Since: next release</sup>
Scroll the tiling view when moving the mouse cursor against a monitor edge during drag-and-drop (DnD).
Also works on a touchscreen.
+1
View File
@@ -24,6 +24,7 @@
* [Window Rules](./Configuration:-Window-Rules.md)
* [Layer Rules](./Configuration:-Layer-Rules.md)
* [Animations](./Configuration:-Animations.md)
* [Gestures](./Configuration:-Gestures.md)
* [Debug Options](./Configuration:-Debug-Options.md)
## Development