App:Library:LVGL:docs:Layouts:Flex

提供: robot-jp wiki
ナビゲーションに移動検索に移動

https://docs.lvgl.io/8.2/layouts/flex.html

Flex

Overview

英文 自動翻訳

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 lv_obj_set_layout(obj, LV_LAYOUT_FLEX).

Note that the flex layout feature of LVGL needs to be globally enabled with LV_USE_FLEX in lv_conf.h.

Flexbox（または略してFlex）はCSSFlexboxのサブセットです。

アイテムを行または列（トラック）に配置し、ラッピングを処理し、アイテムとトラックの間隔を調整し、ハンドルを大きくして、最小/最大の幅と高さに関して残りのスペースをアイテムが埋めるようにします。

オブジェクトフレックスコンテナを作成するには、lv_obj_set_layout(obj, LV_LAYOUT_FLEX)を呼び出します。

LVGLのフレックスレイアウト機能は、lv_conf.hの中のLV_USE_FLEXをグローバルに有効にする必要があることに注意してください。

戻る : Previous


Terms

英文 自動翻訳
  • 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
  • トラック：行または列
  • 主な方向：行または列、アイテムが配置される方向
  • 交差方向：主方向に垂直
  • ラップ：トラックにスペースがなくなった場合、新しいトラックが開始されます
  • 成長：アイテムに設定すると、トラックの残りのスペースを埋めるように成長します。使用可能なスペースは、成長値に応じてアイテム間で分散されます（値が大きいほどスペースが多くなります）
  • ギャップ：行と列の間のスペース、またはトラック上のアイテム
戻る : Previous


Simple interface

英文 自動翻訳

With the following functions you can set a Flex layout on any parent.

次の関数を使用して、任意の親にFlexレイアウトを設定できます。
戻る : Previous


Flex flow

英文 自動翻訳

lv_obj_set_flex_flow(obj, flex_flow)

The possible values for flex_flow are:

  • LV_FLEX_FLOW_ROW Place the children in a row without wrapping
  • LV_FLEX_FLOW_COLUMN Place the children in a column without wrapping
  • LV_FLEX_FLOW_ROW_WRAP Place the children in a row with wrapping
  • LV_FLEX_FLOW_COLUMN_WRAP Place the children in a column with wrapping
  • LV_FLEX_FLOW_ROW_REVERSE Place the children in a row without wrapping but in reversed order
  • LV_FLEX_FLOW_COLUMN_REVERSE Place the children in a column without wrapping but in reversed order
  • LV_FLEX_FLOW_ROW_WRAP_REVERSE Place the children in a row with wrapping but in reversed order
  • LV_FLEX_FLOW_COLUMN_WRAP_REVERSE Place the children in a column with wrapping but in reversed order


lv_obj_set_flex_flow(obj, flex_flow)

flex_flowで設定可能な値は次のとおりです。

  • LV_FLEX_FLOW_ROWラップせずに子供たちを一列に並べる
  • LV_FLEX_FLOW_COLUMN子をラップせずに列に配置します
  • LV_FLEX_FLOW_ROW_WRAPラッピングで子供たちを一列に並べる
  • LV_FLEX_FLOW_COLUMN_WRAP子をラッピングして列に配置します
  • LV_FLEX_FLOW_ROW_REVERSE子を折り返すことなく、逆の順序で一列に配置します
  • LV_FLEX_FLOW_COLUMN_REVERSE子を折り返すことなく、逆の順序で列に配置します
  • LV_FLEX_FLOW_ROW_WRAP_REVERSE子をラッピングして、逆の順序で一列に配置します
  • LV_FLEX_FLOW_COLUMN_WRAP_REVERSE子を折り返しのある列に配置しますが、順序を逆にします
戻る : Previous


Flex align

英文 自動翻訳

To manage the placement of the children use lv_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 LV_FLEX_FLOW_ROW_WRAP. (It's called justify-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 called align-items in CSS)
  • track_cross_place determines how to distribute the tracks (It's called align-content in CSS)

The possible values are:

  • LV_FLEX_ALIGN_START means left on a horizontally and top vertically. (default)
  • LV_FLEX_ALIGN_END means right on a horizontally and bottom vertically
  • LV_FLEX_ALIGN_CENTER simply center
  • 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 to track_cross_place.
  • 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 to track_cross_place.
  • 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 to track_cross_place.


子供の配置を管理するには、lv_obj_set_flex_align(obj,  main_place, cross_place, track_cross_place)を使います。

  • main_place主軸上のトラックでアイテムを配布する方法を決定します。たとえば、の右側にあるアイテムをフラッシュしますLV_FLEX_FLOW_ROW_WRAP。justify-content（ CSSで呼び出されます）
  • cross_placeクロス軸上のトラックでアイテムを配布する方法を決定します。たとえば、アイテムの高さが異なる場合は、トラックの一番下に配置します。align-items（ CSSで呼び出されます）
  • track_cross_placeトラックの配布方法を決定します（align-contentCSSで呼び出されます）

可能な値は次のとおりです。

  • LV_FLEX_ALIGN_START水平に左に、垂直に上に置くことを意味します。（デフォルト）
  • LV_FLEX_ALIGN_END水平方向に右、垂直方向に下を意味します
  • LV_FLEX_ALIGN_CENTER単に中央に配置する
  • LV_FLEX_ALIGN_SPACE_EVENLYアイテムは、任意の2つのアイテム間の間隔（およびエッジまでのスペース）が等しくなるように分散されます。には適用されませんtrack_cross_place。
  • LV_FLEX_ALIGN_SPACE_AROUNDアイテムは、トラック内に均等に配置され、周囲に等間隔で配置されます。すべてのアイテムの両側に等しいスペースがあるため、視覚的にはスペースが等しくないことに注意してください。最初のアイテムには、コンテナの端に対して1単位のスペースがありますが、次のアイテムには独自の間隔が適用されるため、次のアイテムの間に2単位のスペースがあります。track_cross_placeには適用されません。
  • LV_FLEX_ALIGN_SPACE_BETWEENアイテムはトラックに均等に分散されます。最初のアイテムはスタートラインにあり、最後のアイテムはエンドラインにあります。track_cross_placeには適用されません。
戻る : Previous


Flex grow

英文 自動翻訳

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 = 1
  • B with grow = 1
  • C 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 lv_obj_set_flex_grow(child, value). value needs to be > 1 or 0 to disable grow on the child.

フレックスグローを使用して、1人または複数の子をトラックの使用可能なスペースに埋めることができます。より多くの子が成長パラメータを持っている場合、利用可能なスペースは成長値に比例して分配されます。たとえば、残りのスペースは400ピクセルで、growのあるオブジェクトは4つあります。
  • A成長=1
  • B成長=1
  • C成長=2で

AとBのサイズは100ピクセル、Cのサイズは200ピクセルです。

Flex Growthは、lv_obj_set_flex_grow(child, value)を使用して子に設定できます。

子の成長を無効にするには、value>1またはvalue＝0である必要があります。

戻る : Previous


Style interface

英文 自動翻訳

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:

  • FLEX_FLOW
  • FLEX_MAIN_PLACE
  • FLEX_CROSS_PLACE
  • FLEX_TRACK_PLACE
  • FLEX_GROW


Flexに関連するすべての値は、内部のスタイルプロパティであり、他のスタイルプロパティと同様に使用できます。次のフレックス関連のスタイルプロパティがあります。

  • FLEX_FLOW
  • FLEX_MAIN_PLACE
  • FLEX_CROSS_PLACE
  • FLEX_TRACK_PLACE
  • FLEX_GROW
戻る : Previous


Internal padding

英文 自動翻訳

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: lv_style_set_pad_column(&row_container_style,0)

オブジェクト間の最小スペースフレックスボックス挿入を変更するには、フレックスコンテナスタイルに次のプロパティを設定できます。
  • pad_row行間のパディングを設定します。
  • pad_column列間のパディングを設定します。

これらは、たとえば、オブジェクト間にパディングが必要ない場合に使用できます。lv_style_set_pad_column(&row_container_style,0)

戻る : Previous


Other features

RTL

英文 自動翻訳

If the base direction of the container is set the LV_BASE_DIR_RTL the meaning of LV_FLEX_ALIGN_START and LV_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.

コンテナの基本方向がLV_BASE_DIR_RTLに設定されている場合、レイアウト上でのLV_FLEX_ALIGN_STARTとLV_FLEX_ALIGN_ENDの意味がROWにより入れ替わります。つまり、STARTが右を意味します。

ROWレイアウト上のアイテムとCOLUMNトラックは、右から左に配置されます。

戻る : Previous


New track

英文 自動翻訳

You can force Flex to put an item into a new line with lv_obj_add_flag(child, LV_OBJ_FLAG_FLEX_IN_NEW_TRACK).

lv_obj_add_flag(child, LV_OBJ_FLAG_FLEX_IN_NEW_TRACK)を使用してFlexにアイテムを新しい行を強制的に配置させます。
戻る : Previous


Example

A simple row and a column layout with flexbox

英文 自動翻訳

LVGL docs example 024.png

Arrange items in rows with wrap and even spacing

LVGL docs example 025.png

Demonstrate flex grow

LVGL docs example 026.png

Demonstrate flex grow.

LVGL docs example 027.png

Demonstrate column and row gap style properties

LVGL docs example 028.png

RTL base direction changes order of the items

LVGL docs example 029.png

戻る : Previous


API

英文 自動翻訳

Enums

enum lv_flex_align_t

Values:
enumerator LV_FLEX_ALIGN_START
enumerator LV_FLEX_ALIGN_END
enumerator LV_FLEX_ALIGN_CENTER
enumerator LV_FLEX_ALIGN_SPACE_EVENLY
enumerator LV_FLEX_ALIGN_SPACE_AROUND
enumerator LV_FLEX_ALIGN_SPACE_BETWEEN

enum lv_flex_flow_t

Values:
enumerator LV_FLEX_FLOW_ROW
enumerator LV_FLEX_FLOW_COLUMN
enumerator LV_FLEX_FLOW_ROW_WRAP
enumerator LV_FLEX_FLOW_ROW_REVERSE
enumerator LV_FLEX_FLOW_ROW_WRAP_REVERSE
enumerator LV_FLEX_FLOW_COLUMN_WRAP
enumerator LV_FLEX_FLOW_COLUMN_REVERSE
enumerator LV_FLEX_FLOW_COLUMN_WRAP_REVERSE

Functions

LV_EXPORT_CONST_INT(LV_OBJ_FLAG_FLEX_IN_NEW_TRACK)

void lv_flex_init(void)

Initialize a flex layout the default values
Parameters
flex -- pointer to a flex layout descriptor

void lv_obj_set_flex_flow(lv_obj_t *obj, lv_flex_flow_t flow)

Set hot the item should flow
Parameters
  • flex -- pointer to a flex layout descriptor
  • flow -- an element of lv_flex_flow_t.

void lv_obj_set_flex_align(lv_obj_t *obj, lv_flex_align_t main_place, lv_flex_align_t cross_place, lv_flex_align_t track_cross_place)

Set how to place (where to align) the items and tracks
Parameters
  • flex -- pointer: to a flex layout descriptor
  • main_place -- where to place the items on main axis (in their track). Any value of lv_flex_align_t.
  • cross_place -- where to place the item in their track on the cross axis. LV_FLEX_ALIGN_START/END/CENTER
  • track_place -- where to place the tracks in the cross direction. Any value of lv_flex_align_t.

void lv_obj_set_flex_grow(lv_obj_t *obj, uint8_t grow)

Sets the width or height (on main axis) to grow the object in order fill the free space
Parameters
  • obj -- pointer to an object. The parent must have flex layout else nothing will happen.
  • grow -- a value to set how much free space to take proportionally to other growing items.

void lv_style_set_flex_flow(lv_style_t *style, lv_flex_flow_t value)

void lv_style_set_flex_main_place(lv_style_t *style, lv_flex_align_t value)

void lv_style_set_flex_cross_place(lv_style_t *style, lv_flex_align_t value)

void lv_style_set_flex_track_place(lv_style_t *style, lv_flex_align_t value)

void lv_style_set_flex_grow(lv_style_t *style, uint8_t value)

void lv_obj_set_style_flex_flow(lv_obj_t *obj, lv_flex_flow_t value, lv_style_selector_t selector)

void lv_obj_set_style_flex_main_place(lv_obj_t *obj, lv_flex_align_t value, lv_style_selector_t selector)

void lv_obj_set_style_flex_cross_place(lv_obj_t *obj, lv_flex_align_t value, lv_style_selector_t selector)

void lv_obj_set_style_flex_track_place(lv_obj_t *obj, lv_flex_align_t value, lv_style_selector_t selector)

void lv_obj_set_style_flex_grow(lv_obj_t *obj, uint8_t value, lv_style_selector_t selector)

static inline lv_flex_flow_t lv_obj_get_style_flex_flow(const lv_obj_t *obj, uint32_t part)

static inline lv_flex_align_t lv_obj_get_style_flex_main_place(const lv_obj_t *obj, uint32_t part)

static inline lv_flex_align_t lv_obj_get_style_flex_cross_place(const lv_obj_t *obj, uint32_t part)

static inline lv_flex_align_t lv_obj_get_style_flex_track_place(const lv_obj_t *obj, uint32_t part)

static inline uint8_t lv_obj_get_style_flex_grow(const lv_obj_t *obj, uint32_t part)

Variables

uint32_t LV_LAYOUT_FLEX

lv_style_prop_t LV_STYLE_FLEX_FLOW

lv_style_prop_t LV_STYLE_FLEX_MAIN_PLACE

lv_style_prop_t LV_STYLE_FLEX_CROSS_PLACE

lv_style_prop_t LV_STYLE_FLEX_TRACK_PLACE

lv_style_prop_t LV_STYLE_FLEX_GROW

列挙型

列挙型lv_flex_align_t

値：
列挙子LV_FLEX_ALIGN_START
列挙子LV_FLEX_ALIGN_END
列挙子LV_FLEX_ALIGN_CENTER
列挙子LV_FLEX_ALIGN_SPACE_EVENLY
列挙子LV_FLEX_ALIGN_SPACE_AROUND
列挙子LV_FLEX_ALIGN_SPACE_BETWEEN

列挙型lv_flex_flow_t

値：
列挙子LV_FLEX_FLOW_ROW
列挙子LV_FLEX_FLOW_COLUMN
列挙子LV_FLEX_FLOW_ROW_WRAP
列挙子LV_FLEX_FLOW_ROW_REVERSE
列挙子LV_FLEX_FLOW_ROW_WRAP_REVERSE
列挙子LV_FLEX_FLOW_COLUMN_WRAP
列挙子LV_FLEX_FLOW_COLUMN_REVERSE
列挙子LV_FLEX_FLOW_COLUMN_WRAP_REVERSE

機能

LV_EXPORT_CONST_INT（LV_OBJ_FLAG_FLEX_IN_NEW_TRACK）

void lv_flex_init（void）

フレックスレイアウトを初期化しますデフォルト値
パラメーター
flex-フレックスレイアウト記述子へのポインタ

void lv_obj_set_flex_flow（lv_obj_t * obj、lv_flex_flow_t flow）

アイテムが流れるはずのホットセット
パラメーター
  • flex-フレックスレイアウト記述子へのポインタ
  • フロー-lv_flex_flow_tの要素。

void lv_obj_set_flex_align（lv_obj_t * obj、lv_flex_align_t main_place、lv_flex_align_t cross_place、lv_flex_align_t track_cross_place）

アイテムとトラックの配置方法（配置場所）を設定します
パラメーター
  • flex-ポインタ：フレックスレイアウト記述子へ
  • main_place-アイテムを主軸（トラック内）に配置する場所。lv_flex_align_tの任意の値。
  • cross_place-クロス軸上のトラックのアイテムを配置する場所。LV_FLEX_ALIGN_START/END/CENTER
  • track_place-クロス方向にトラックを配置する場所。lv_flex_align_tの任意の値。

void lv_obj_set_flex_grow（lv_obj_t * obj、uint8_t grow）

空き領域を埋めるためにオブジェクトを拡大するための幅または高さ（主軸上）を設定します
パラメーター
  • obj-オブジェクトへのポインタ。親はフレックスレイアウトを持っている必要があり、そうでない場合は何も起こりません。
  • grow-他の成長するアイテムに比例して取る空き領域を設定する値。

void lv_style_set_flex_flow（lv_style_t * style、lv_flex_flow_t value）

void lv_style_set_flex_main_place（lv_style_t * style、lv_flex_align_t value）

void lv_style_set_flex_cross_place（lv_style_t * style、lv_flex_align_t value）

void lv_style_set_flex_track_place（lv_style_t * style、lv_flex_align_t value）

void lv_style_set_flex_grow（lv_style_t * style、uint8_t value）

void lv_obj_set_style_flex_flow（lv_obj_t * obj、lv_flex_flow_t value、lv_style_selector_tセレクター）

void lv_obj_set_style_flex_main_place（lv_obj_t * obj、lv_flex_align_t value、lv_style_selector_tセレクター）

void lv_obj_set_style_flex_cross_place（lv_obj_t * obj、lv_flex_align_t value、lv_style_selector_tセレクター）

void lv_obj_set_style_flex_track_place（lv_obj_t * obj、lv_flex_align_t value、lv_style_selector_tセレクター）

void lv_obj_set_style_flex_grow（lv_obj_t * obj、uint8_t value、lv_style_selector_tセレクター）

static inline lv_flex_flow_t lv_obj_get_style_flex_flow（const lv_obj_t * obj、uint32_t part）

static inline lv_flex_align_t lv_obj_get_style_flex_main_place（const lv_obj_t * obj、uint32_t part）

static inline lv_flex_align_t lv_obj_get_style_flex_cross_place（const lv_obj_t * obj、uint32_t part）

static inline lv_flex_align_t lv_obj_get_style_flex_track_place（const lv_obj_t * obj、uint32_t part）

静的インラインuint8_tlv_obj_get_style_flex_grow（const lv_obj_t * obj、uint32_t part）

変数

uint32_t LV_LAYOUT_FLEX

lv_style_prop_t LV_STYLE_FLEX_FLOW

lv_style_prop_t LV_STYLE_FLEX_MAIN_PLACE

lv_style_prop_t LV_STYLE_FLEX_CROSS_PLACE

lv_style_prop_t LV_STYLE_FLEX_TRACK_PLACE

lv_style_prop_t LV_STYLE_FLEX_GROW


戻る : Previous
「https://robot-jp.com/wiki/index.php?title=App:Library:LVGL:docs:Layouts:Flex&oldid=3743」から取得