Flow Elements
A flow element takes a set of elements (including elements that are
duplicated for each task or desk) and arranges them relative to eachother. It
may also resize them to ensure that they all fit.
(prefix)Elements [element-list]
Mandatory setting
Lists the elements to be arranged. Given as a space-separated list of
their names.
(prefix)Rows [int or "variable"]
Default: 1
The number of rows of elements in this flow. If set to variable, then the
number of rows is determined based on
RowThickness and the geometry
of the context the flow is in.
(prefix)RowThickness [int]
Default: 16
If (prefix)Rows is "variable", the thickness (in pixels) of the rows in
this flow. The number of rows will be automatically adjusted according to
the total thickness.
(prefix)LengthFirst [bool]
Default: false
If this flow has more than one row, this option indicates whether the first
row should be filled (made as wide as it can be) before moving onto the
second and subsequent rows.
(prefix)Vertical [true|false|inherit]
Default: inherit
Whether this flow arranges elements vertically. By default, this setting
is inherited from the flow or window it is nested in.
Default: none
The animation which is played when a new element is added to this flow,
because it contained a .desks or .tasks element and a new desk or task
was created.
Default: none
The animation which is played when a new element is removed from this
flow, because it contained a .desks or .tasks element and a desk or
task was removed.
Elements can be either:
-
[element]
Where [element] is the name of another layout element, which will be
shown inside the flow element.
-
.desks([element])
Where [element] is the name of another layout element, which will be
shown inside the flow element and repeated for every desk. These elements
get a context desk, which is applied recursively to all their children.
-
.tasks([element])
Where [element] is the name of another layout element, which will be
shown inside the flow element and repeated for every task. These elements
get a context task, which is applied recursively to all their children.
-
[N]
Where [N] is an integer. Inserts N pixels of empty space.
-
.[N]
Where [N] is an integer. Inserts N pixels of optional empty space, which
may shrink or be omitted if the flow is full or close to full.
-
.freeSpace
If there is extra space left over, controls where it goes. If there is no
.freeSpace element, leftover space is added to the end. If there is more
than one .freeSpace element, free space is divided equally between them,
with odd pixels going to the first ones.