> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/classes/uiflexitem.md).

# UIFlexItem

UIFlexItem : `UIComponent`

## Overview

부모에 배치된 UIListLayout이 남거나 모자란 공간을 나눠줄 때, 이 UI 요소 하나가 어떻게 공간을 나눠 가질지를 개별적으로 지정하는 UI 컴포넌트입니다.

공간을 더 받아 커질지, 공간을 내놓고 줄어들지, 형제 요소들과 어떤 비율로 나눌지, 그리고 줄 안에서 교차축 방향으로 어디에 놓일지를 정할 수 있습니다. UIFlexItem이 있는 UI 요소에는 UIListLayout의 기본 배분 방식보다 UIFlexItem의 설정이 우선 적용됩니다.

UIFlexItem은 공간을 배분할 UI 요소의 자식으로 배치하여 사용합니다. 부모에 UIListLayout이 없으면 UI 요소는 UIFlexItem의 영향을 받지 않고 원래대로 배치됩니다. 하나의 UI 요소에 UIFlexItem이 여러 개 있는 경우 첫 번째 UIFlexItem만 적용됩니다.

## Properties

### FlexMode

`Enum.UIFlexMode`

UI 요소가 남는 공간 또는 모자란 공간을 나눠 가질지 여부와 그 방식을 지정하는 속성입니다.

Custom으로 지정하면 GrowRatio와 ShrinkRatio 값이 그대로 배분 비율로 사용됩니다. 기본값은 None입니다.

#### Code Samples

### GrowRatio

`number`

남는 공간을 형제 요소들과 나눌 때 이 UI 요소가 받을 몫의 비율을 지정하는 속성입니다.

남는 공간은 각 요소의 GrowRatio 값에 비례하여 나뉩니다. 이 값은 FlexMode가 Custom일 때만 사용되며, 음수는 0으로 처리됩니다. 기본값은 1입니다.

#### Code Samples

### ItemLineAlignment

`Enum.ItemLineAlignment`

줄 안에서 이 UI 요소 하나만 교차축 방향으로 어디에 놓일지를 지정하는 속성입니다.

Automatic으로 지정하면 UIListLayout의 ItemLineAlignment 설정을 따릅니다. 기본값은 Automatic입니다.

#### Code Samples

### ShrinkRatio

`number`

공간이 모자랄 때 이 UI 요소가 형제 요소들과 나눠 줄어들 몫의 비율을 지정하는 속성입니다.

줄어드는 양은 ShrinkRatio 값과 요소의 원래 크기를 곱한 값에 비례하여 나뉩니다. 이 값은 FlexMode가 Custom일 때만 사용되며, 음수는 0으로 처리됩니다. 기본값은 1입니다.

#### Code Samples

## Methods

## Events
