PolytreeDE/rofi
1
0
Fork 0
mirror of https://github.com/davatorium/rofi.git synced 2025-07-31 21:59:25 -04:00
Code Releases Activity

Reflect changes to widget names, mention "enabled" property

Browse source
This commit is contained in:
Rasmus Steinke 2017-11-01 21:58:07 +01:00
parent fabf3d544a
commit d32c6cf84b
1 changed files with 55 additions and 47 deletions
Download patch file Download diff file Expand all files Collapse all files

102
doc/rofi-theme.5.markdown
View file

@ -79,10 +79,10 @@ make inheritance of properties clearer.
} }
/* Element theme section. */ /* Element theme section. */
#{element path} { {element path} {
// list of properties // list of properties
} }
#{elements... } { {elements... } {
// list of properties // list of properties
} }
``` ```
@ -113,10 +113,10 @@ Multiple elements can be specified by a `,`.
This is a valid element name: This is a valid element name:
``` ```
#element normal.normal { element normal.normal {
background-color: blue; background-color: blue;
} }
#button { button {
background-color: blue; background-color: blue;
} }
``` ```
@ -124,7 +124,7 @@ This is a valid element name:
And is identical to: And is identical to:
``` ```
#element normal normal, button { element normal normal, button {
background-color: blue; background-color: blue;
} }
``` ```
@ -134,18 +134,18 @@ Each section inherits the global properties. Properties can be explicitely inher
In the following example: In the following example:
``` ```
#window { window {
a: 1; a: 1;
b: 2; b: 2;
} }
#mainbox { mainbox {
a: inherit; a: inherit;
b: 4; b: 4;
c: 8; c: 8;
} }
``` ```
The element `#mainbox` will have the following set of properties (if `mainbox` is a child of `window`): The element `mainbox` will have the following set of properties (if `mainbox` is a child of `window`):
``` ```
a: 1; a: 1;
@ -398,6 +398,14 @@ north west | north | north east
south west | south | south east south west | south | south east
``` ```
## Visibility
It is possible to hide widgets:
inputbar {
enabled: false;
}
## Reference ## Reference
* Format: `@{PROPERTY NAME}` * Format: `@{PROPERTY NAME}`
@ -417,7 +425,7 @@ But this is:
myhigh: bold #FAA; myhigh: bold #FAA;
} }
#window { window {
highlight: @myhigh; highlight: @myhigh;
} }
``` ```
@ -442,7 +450,7 @@ The `keyword` in the list refers to an widget name.
Inherits the property from its parent widget. Inherits the property from its parent widget.
``` ```
#mainbox { mainbox {
border-color: inherit; border-color: inherit;
} }
``` ```
@ -456,20 +464,20 @@ Some widgets have an extra state.
For example: For example:
``` ```
#element selected { element selected {
} }
``` ```
Here `#element selected` is the name of the widget, `selected` is the state of the widget. Here `element selected` is the name of the widget, `selected` is the state of the widget.
The difference between dots and spaces is purely cosmetic. These are all the same: The difference between dots and spaces is purely cosmetic. These are all the same:
``` ```
#element .selected { element .selected {
#element.selected { element.selected {
} }
#element selected { element selected {
} }
``` ```
@ -479,21 +487,21 @@ The difference between dots and spaces is purely cosmetic. These are all the sam
The current widgets available in **rofi**: The current widgets available in **rofi**:
* `#window` * `window`
* `#overlay`: the overlay widget. * `overlay`: the overlay widget.
* `#mainbox`: The mainbox box. * `mainbox`: The mainbox box.
* `#inputbar`: The input bar box. * `inputbar`: The input bar box.
* `#box`: the horizontal @box packing the widgets * `box`: the horizontal @box packing the widgets
* `#case-indicator`: the case/sort indicator @textbox * `case-indicator`: the case/sort indicator @textbox
* `#prompt`: the prompt @textbox * `prompt`: the prompt @textbox
* `#entry`: the main entry @textbox * `entry`: the main entry @textbox
* `#listview`: The listview. * `listview`: The listview.
* `#scrollbar`: the listview scrollbar * `scrollbar`: the listview scrollbar
* `#element`: the entries in the listview * `element`: the entries in the listview
* `#sidebar`: the main horizontal @box packing the buttons. * `sidebar`: the main horizontal @box packing the buttons.
* `#button`: the buttons @textbox for each mode * `button`: the buttons @textbox for each mode
* `#message`: The container holding the textbox. * `message`: The container holding the textbox.
* `#textbox`: the message textbox * `textbox`: the message textbox
Note that these path names match the default theme. Themes that provide a custom layout will have different Note that these path names match the default theme. Themes that provide a custom layout will have different
element paths. element paths.
@ -509,9 +517,9 @@ These are appended after the name or class of the widget.
### Example: ### Example:
`#button selected.normal { }` `button selected.normal { }`
`#element selected.urgent { }` `element selected.urgent { }`
Currently only the entrybox and scrollbar have states: Currently only the entrybox and scrollbar have states:
@ -534,7 +542,7 @@ These can be mixed.
Example: Example:
``` ```
#nametotextbox selected.active { nametotextbox selected.active {
background-color: #003642; background-color: #003642;
text-color: #008ed4; text-color: #008ed4;
} }
@ -656,29 +664,29 @@ The current layout of **rofi** is structured as follows:
``` ```
|------------------------------------------------------------------------------------| |------------------------------------------------------------------------------------|
| #window {BOX:vertical} | | window {BOX:vertical} |
| |-------------------------------------------------------------------------------| | | |-------------------------------------------------------------------------------| |
| | #mainbox {BOX:vertical} | | | | mainbox {BOX:vertical} | |
| | |---------------------------------------------------------------------------| | | | | |---------------------------------------------------------------------------| | |
| | | #inputbar {BOX:horizontal} | | | | | | inputbar {BOX:horizontal} | | |
| | | |---------| |-----------------------------------------------------| |---| | | | | | | |---------| |-----------------------------------------------------| |---| | | |
| | | | #prompt | | #entry | |#ci| | | | | | | | prompt | | entry | |ci | | | |
| | | |---------| |-----------------------------------------------------| |---| | | | | | | |---------| |-----------------------------------------------------| |---| | | |
| | |---------------------------------------------------------------------------| | | | | |---------------------------------------------------------------------------| | |
| | | | | | | |
| | |---------------------------------------------------------------------------| | | | | |---------------------------------------------------------------------------| | |
| | | #message | | | | | | message | | |
| | | |-----------------------------------------------------------------------| | | | | | | |-----------------------------------------------------------------------| | | |
| | | | #textbox | | | | | | | | textbox | | | |
| | | |-----------------------------------------------------------------------| | | | | | | |-----------------------------------------------------------------------| | | |
| | |---------------------------------------------------------------------------| | | | | |---------------------------------------------------------------------------| | |
| | | | | | | |
| | |-----------------------------------------------------------------------------| | | | |-----------------------------------------------------------------------------| |
| | | #listview | | | | | listview | |
| | |-----------------------------------------------------------------------------| | | | |-----------------------------------------------------------------------------| |
| | | | | | | |
| | |---------------------------------------------------------------------------| | | | | |---------------------------------------------------------------------------| | |
| | | #sidebar {BOX:horizontal} | | | | | | sidebar {BOX:horizontal} | | |
| | | |---------------| |---------------| |--------------| |---------------| | | | | | | |---------------| |---------------| |--------------| |---------------| | | |
| | | | Button | | Button | | Button | | Button | | | | | | | | Button | | Button | | Button | | Button | | | |
| | | |---------------| |---------------| |--------------| |---------------| | | | | | | |---------------| |---------------| |--------------| |---------------| | | |
@ -731,7 +739,7 @@ Below is an example of a theme emulating dmenu:
font: "Times New Roman 12"; font: "Times New Roman 12";
} }
#window { window {
anchor: north; anchor: north;
location: north; location: north;
width: 100%; width: 100%;
@ -739,26 +747,26 @@ Below is an example of a theme emulating dmenu:
children: [ horibox ]; children: [ horibox ];
} }
#horibox { horibox {
orientation: horizontal; orientation: horizontal;
children: [ prompt, entry, listview ]; children: [ prompt, entry, listview ];
} }
#listview { listview {
layout: horizontal; layout: horizontal;
spacing: 5px; spacing: 5px;
lines: 10; lines: 10;
} }
#entry { entry {
expand: false; expand: false;
width: 10em; width: 10em;
} }
#element { element {
padding: 0px 2px; padding: 0px 2px;
} }
#element selected { element selected {
background-color: SteelBlue; background-color: SteelBlue;
} }
``` ```