summaryrefslogtreecommitdiffstats
path: root/mkdocs/docs/guides/Positioning/theme3-positioning.markdown
blob: 71e26bcb67cff6608ca9023871944870204b6884 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# 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;}"
```