1
0
Fork 0
mirror of https://github.com/davatorium/rofi.git synced 2024-11-18 13:54:36 -05:00
rofi/mkdocs/docs/guides/Positioning/theme3-positioning.markdown
2023-03-27 12:40:59 +02:00

73 lines
2 KiB
Markdown

# Positioning Rofi on the monitor
In the current theme format you set these properties on the `window` widget.
The first, location, determines where **rofi** is placed on the monitor, the
second what point of the **rofi** window connects there. This sounds
complicated, but it ain't.
## location setting
The location setting determines the place of the window on the monitor.
The location setting supports the following values:
- north
- northeast
- northwest
- south
- southeast
- southwest
- east
- west
- center
This is depicted in the diagram below:
![location](anchors.svg)
## anchor setting
The anchor sets what point of the **rofi** window is placed at the specified
*location*.
The *anchor* settings supports the same values as the *location* setting.
If you want the middle of the **rofi** window to be always located at the
center of the monitor set both *location* and *anchor* to `center`.
If the **rofi** window resizes, its center will stay at the center. If you set
the *anchor* to `north` the top of the **rofi** window is at the center of the
monitor, and the window will grow down.
If you set the *anchor* and *location* to `south`, **rofi** is located at the
bottom center and the window grows up.
> Note that if you set the *anchor* to `south` and the *location* to `north`
> the **rofi** window will be placed above the monitor and might not be
> visible.
> In another blog post we will explain how the dynamic sizing behaviour of
> **rofi** can be tweaked or disabled.
So the following theme setting will place the top of the **rofi** window in the
center of the monitor:
```css
window {
location: center;
anchor: north;
}
```
As depicted here, RED is the location (center of screen), GREEN is the anchor
on **rofi** window (north):
![positions](example-pos.png)
> Quick hint, if you want to quickly test out changes to the theme, without
> editing the file, run **rofi** like:
```bash
rofi -show run -theme-str "window { location: center; anchor: north;}"
```