1
0
Fork 0
mirror of https://github.com/davatorium/rofi.git synced 2024-11-18 13:54:36 -05:00

[Doc] More tweaks to get the formulation right.

This commit is contained in:
Dave Davenport 2023-01-25 23:15:30 +01:00
parent db16c63168
commit bc776fd67c
2 changed files with 25 additions and 14 deletions

View file

@ -1597,9 +1597,10 @@ hitting accept will activate the first entry.
.RE .RE
.SH Listview widget
.PP .PP
The listview widget is special container widget. The listview widget is special container widget.
It has the following children: It has the following fixed children widgets:
.RS .RS
.IP \(bu 2 .IP \(bu 2
@ -1611,8 +1612,11 @@ property.
.RE .RE
.PP .PP
Each entry displayed by listview captured by a \fB\fCbox\fR called \fB\fCelement\fR\&. Each These cannot be changed using the \fB\fCchildren\fR property.
\fB\fCelement\fR can contain the following special widgets:
.PP
Each entries displayed by listview are captured by a \fB\fCbox\fR called \fB\fCelement\fR\&.
An \fB\fCelement\fR widget can contain the following special child widgets:
.RS .RS
.IP \(bu 2 .IP \(bu 2
@ -1625,10 +1629,12 @@ Each entry displayed by listview captured by a \fB\fCbox\fR called \fB\fCelement
.RE .RE
.PP .PP
A child added with another name is seen as a \fB\fCbox\fR, this can be used to tweak By default the \fB\fCelement-icon\fR and \fB\fCelement-text\fR child widgets are added to the
how an entry looks when it expands to available space. This can be useful if \fB\fCelement\fR\&. This can be modified using the \fB\fCchildren\fR property.
there are multiple columns and on filtering the remaining columns should appear
centered with a fixed width. .PP
A child added with another name is seen as a \fB\fCbox\fR, this can be used as dynamic
padding to tweak how an entry looks when it expands to available space.
.SS listview text highlight .SS listview text highlight
.PP .PP

View file

@ -988,24 +988,29 @@ The following properties are currently supported:
Listview requires user input to be unhidden. The list is still present and Listview requires user input to be unhidden. The list is still present and
hitting accept will activate the first entry. hitting accept will activate the first entry.
## Listview widget
The listview widget is special container widget. The listview widget is special container widget.
It has the following children: It has the following fixed children widgets:
* 0 or more `element` widgets of the type box. * 0 or more `element` widgets of the type box.
* An optional `scrollbar` widget. This can be enabled using the scrollbar * An optional `scrollbar` widget. This can be enabled using the scrollbar
property. property.
Each entry displayed by listview captured by a `box` called `element`. Each These cannot be changed using the `children` property.
`element` can contain the following special widgets:
Each entries displayed by listview are captured by a `box` called `element`.
An `element` widget can contain the following special child widgets:
* `element-icon`: An icon widget showing the icon associated to the entry. * `element-icon`: An icon widget showing the icon associated to the entry.
* `element-text`: A textbox widget showing the text associated to the entry. * `element-text`: A textbox widget showing the text associated to the entry.
* `element-index`: A textbox widget that shows the shortcut keybinding number. * `element-index`: A textbox widget that shows the shortcut keybinding number.
A child added with another name is seen as a `box`, this can be used to tweak By default the `element-icon` and `element-text` child widgets are added to the
how an entry looks when it expands to available space. This can be useful if `element`. This can be modified using the `children` property.
there are multiple columns and on filtering the remaining columns should appear
centered with a fixed width. A child added with another name is seen as a `box`, this can be used as dynamic
padding to tweak how an entry looks when it expands to available space.
#### listview text highlight #### listview text highlight