X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=docs%2Fi3bar-protocol.html;h=e84e177719130eb4e489f8f19376cb2d1b321b1e;hb=8924ec1339061840e02c918d36c86dd179a86aac;hp=1e9cb2d6f88f4ea5ce1c76c8f4e8d362c834db88;hpb=5f8114c4a6b86f2260a5ddf4efdf45e93914e599;p=i3%2Fi3.github.io diff --git a/docs/i3bar-protocol.html b/docs/i3bar-protocol.html index 1e9cb2d..e84e177 100644 --- a/docs/i3bar-protocol.html +++ b/docs/i3bar-protocol.html @@ -41,7 +41,7 @@ provides support for colors, urgency, shortening and easy manipulation.

-

1. Rationale for chosing JSON

+

1. Rationale for choosing JSON

Before describing the protocol, let’s cover why JSON is a building block of this protocol.

@@ -145,7 +145,7 @@ i3status and others will output single statuslines in one line, separated by \n.

You can find an example of a shell script which can be used as your status_command in the bar configuration at -http://code.stapelberg.de/git/i3/tree/contrib/trivial-bar-script.sh?h=next

+https://github.com/i3/i3/blob/next/contrib/trivial-bar-script.sh

2.1. Header in detail

@@ -182,7 +182,7 @@ click_events

- If specified and true i3bar will write a infinite array (same as above) + If specified and true i3bar will write an infinite array (same as above) to your stdin.

@@ -322,7 +322,8 @@ markup

A string that indicates how the text of the block should be parsed. Set to "pango" to use Pango markup. - Set to "none" to not use any markup (default). + Set to "none" to not use any markup (default). Pango markup only works + if you use a pango font.

@@ -394,7 +395,7 @@ x, y

- X11 root window coordinates where the click occured + X11 root window coordinates where the click occurred

@@ -405,6 +406,23 @@ button X11 button ID (for example 1 to 3 for left/middle/right mouse button)

+
+relative_x, relative_y +
+
+

+ Coordinates where the click occurred, with respect to the top left corner + of the block +

+
+
+width, height +
+
+

+ Width and height (in px) of the block +

+

Example:

@@ -414,7 +432,11 @@ button "instance": "eth0", "button": 1, "x": 1320, - "y": 1400 + "y": 1400, + "relative_x": 12, + "relative_y": 8, + "width": 50, + "height": 22 }