diff options
Diffstat (limited to 'mkdocs/docs/guides/Positioning/theme3-positioning.markdown')
-rw-r--r-- | mkdocs/docs/guides/Positioning/theme3-positioning.markdown | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/mkdocs/docs/guides/Positioning/theme3-positioning.markdown b/mkdocs/docs/guides/Positioning/theme3-positioning.markdown new file mode 100644 index 00000000..83298232 --- /dev/null +++ b/mkdocs/docs/guides/Positioning/theme3-positioning.markdown @@ -0,0 +1,68 @@ +# 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;}" +``` |