The Flexbox (or Flex for short) is a subset of CSS Flexbox.
It can arrange items into rows or columns (tracks), handle wrapping, adjust the spacing between the items and tracks, handle grow to make the item(s) fill the remaining space with respect to min/max width and height.
To make an object flex container call :cpplv_obj_set_layout(obj, LV_LAYOUT_FLEX)
.
Note that the flex layout feature of LVGL needs to be globally enabled with :cLV_USE_FLEX
in lv_conf.h
.
- tracks: the rows or columns
- main direction: row or column, the direction in which the items are placed
- cross direction: perpendicular to the main direction
- wrap: if there is no more space in the track a new track is started
- grow: if set on an item it will grow to fill the remaining space on the track. The available space will be distributed among items respective to their grow value (larger value means more space)
- gap: the space between the rows and columns or the items on a track
With the following functions you can set a Flex layout on any parent.
:cpplv_obj_set_flex_flow(obj, flex_flow)
The possible values for flex_flow
are:
- :cpp
LV_FLEX_FLOW_ROW
: Place the children in a row without wrapping - :cpp
LV_FLEX_FLOW_COLUMN
: Place the children in a column without wrapping - :cpp
LV_FLEX_FLOW_ROW_WRAP
: Place the children in a row with wrapping - :cpp
LV_FLEX_FLOW_COLUMN_WRAP
: Place the children in a column with wrapping - :cpp
LV_FLEX_FLOW_ROW_REVERSE
: Place the children in a row without wrapping but in reversed order - :cpp
LV_FLEX_FLOW_COLUMN_REVERSE
: Place the children in a column without wrapping but in reversed order - :cpp
LV_FLEX_FLOW_ROW_WRAP_REVERSE
: Place the children in a row with wrapping but in reversed order - :cpp
LV_FLEX_FLOW_COLUMN_WRAP_REVERSE
: Place the children in a column with wrapping but in reversed order
To manage the placement of the children use :cpplv_obj_set_flex_align(obj, main_place, cross_place, track_cross_place)
main_place
determines how to distribute the items in their track on the main axis. E.g. flush the items to the right on :cppLV_FLEX_FLOW_ROW_WRAP
. (It's calledjustify-content
in CSS)cross_place
determines how to distribute the items in their track on the cross axis. E.g. if the items have different height place them to the bottom of the track. (It's calledalign-items
in CSS)track_cross_place
determines how to distribute the tracks (It's calledalign-content
in CSS)
The possible values are:
- :cpp
LV_FLEX_ALIGN_START
: means left on a horizontally and top vertically (default) - :cpp
LV_FLEX_ALIGN_END
: means right on a horizontally and bottom vertically - :cpp
LV_FLEX_ALIGN_CENTER
: simply center - :cpp
LV_FLEX_ALIGN_SPACE_EVENLY
: items are distributed so that the spacing between any two items (and the space to the edges) is equal. Does not apply totrack_cross_place
. - :cpp
LV_FLEX_ALIGN_SPACE_AROUND
: items are evenly distributed in the track with equal space around them. Note that visually the spaces aren't equal, since all the items have equal space on both sides. The first item will have one unit of space against the container edge, but two units of space between the next item because that next item has its own spacing that applies. Not applies totrack_cross_place
. - :cpp
LV_FLEX_ALIGN_SPACE_BETWEEN
: items are evenly distributed in the track: first item is on the start line, last item on the end line. Not applies totrack_cross_place
.
Flex grow can be used to make one or more children fill the available space on the track. When more children have grow parameters, the available space will be distributed proportionally to the grow values. For example, there is 400 px remaining space and 4 objects with grow:
A
with grow = 1B
with grow = 1C
with grow = 2
A
and B
will have 100 px size, and C
will have 200 px size.
Flex grow can be set on a child with :cpplv_obj_set_flex_grow(child, value)
. value
needs to be > 1 or 0 to disable grow on the child.
All the Flex-related values are style properties under the hood and you can use them similarly to any other style property.
The following flex related style properties exist:
- :cpp
FLEX_FLOW
- :cpp
FLEX_MAIN_PLACE
- :cpp
FLEX_CROSS_PLACE
- :cpp
FLEX_TRACK_PLACE
- :cpp
FLEX_GROW
To modify the minimum space flexbox inserts between objects, the following properties can be set on the flex container style:
pad_row
Sets the padding between the rows.pad_column
Sets the padding between the columns.
These can for example be used if you don't want any padding between your objects: :cpplv_style_set_pad_column(&row_container_style,0)
If the base direction of the container is set the :cppLV_BASE_DIR_RTL
the meaning of :cppLV_FLEX_ALIGN_START
and :cppLV_FLEX_ALIGN_END
is swapped on ROW
layouts. I.e. START
will mean right.
The items on ROW
layouts, and tracks of COLUMN
layouts will be placed from right to left.
You can force Flex to put an item into a new line with :cpplv_obj_add_flag(child, LV_OBJ_FLAG_FLEX_IN_NEW_TRACK)
.