X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=docs%2Fi3bar-protocol.html;h=509236868095161240673bdd0b60e655ac62ff4f;hb=7b492b3e98dcbee79808d2c04d4f015990bbc0e1;hp=222543fed00ba229db2d47c55d5e4b6ec50cbb46;hpb=032464499ebd3845d47ef437ccae5093e263af32;p=i3%2Fi3.github.io diff --git a/docs/i3bar-protocol.html b/docs/i3bar-protocol.html index 222543f..5092368 100644 --- a/docs/i3bar-protocol.html +++ b/docs/i3bar-protocol.html @@ -2,15 +2,15 @@ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> - + - + i3: i3bar input protocol @@ -22,8 +22,9 @@ window.onload = function(){asciidoc.footnotes();}
@@ -103,7 +104,7 @@ consists of a single JSON hash:

All features example:

-
{ "version": 1, "stop_signal": 10, "cont_signal": 12 }
+
{ "version": 1, "stop_signal": 10, "cont_signal": 12, "click_events": true }

(Note that before i3 v4.3 the precise format had to be {"version":1}, byte-for-byte.)

@@ -176,6 +177,15 @@ cont_signal The default value (if none is specified) is SIGCONT.

+
+click_events +
+
+

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

+
@@ -188,7 +198,8 @@ full_text

The most simple block you can think of is one which just includes the only required key, the full_text key. i3bar will display the string - value and that’s it. + value parsed as + Pango markup.

@@ -241,7 +252,7 @@ align

- Align text on the center (default), right or left of the block, when + Align text on the center, right or left (default) of the block, when the minimum width of the latter, specified by the min_width key, is not reached.

@@ -331,6 +342,56 @@ used to set the minimum width:

} +
+

2.3. Click events

+

If enabled i3bar will send you notifications if the user clicks on a block and +looks like this:

+
+
+name +
+
+

+ Name of the block, if set +

+
+
+instance +
+
+

+ Instance of the block, if set +

+
+
+x, y +
+
+

+ X11 root window coordinates where the click occured +

+
+
+button +
+
+

+ X11 button ID (for example 1 to 3 for left/middle/right mouse button) +

+
+
+

Example:

+
+
+
{
+ "name": "ethernet",
+ "instance": "eth0",
+ "button": 1,
+ "x": 1320,
+ "y": 1400
+}
+
+