목록 및 유연한 레이아웃

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

UIListLayout은 형제 GuiObjects를 부모 컨테이너 내에서 수평 행 또는 수직 열로 배치합니다. 형제 개체를 추가하거나 제거할 때마다 레이아웃이 그에 맞게 조정됩니다.

채우기 방향

FillDirection 속성은 목록 레이아웃의 형제들이 렌더링되는 방향을 결정합니다.

UIListLayouts는 수평 또는 수직의 FillDirection을 설명합니다.

정렬은 레이아웃의 SortOrder 속성에 의해 결정되며, 이는 각 항목의 LayoutOrder 정수 값을 기준으로 하는 오름차순이나 항목의 Name에 기반한 알파벳순일 수 있습니다.

수치 LayoutOrder 정렬 또는 알파벳 순 Name 정렬을 설명하는 목록 레이아웃 예시.

정렬

HorizontalAlignmentVerticalAlignment 속성은 목록의 형제들이 서로 및 목록의 전반적인 경계 내에서의 XY 정렬을 결정합니다. 예를 들어, VerticalAlignmentCenter인 수평 채워진 목록은 목록의 형제들을 서로 중앙에 정렬하고 목록을 그 컨테이너 내에서 수직으로 중앙에 배치합니다.

센터의 VerticalAlignment를 설명하는 목록 레이아웃.

감싸기

Wraps 불리언은 형제가 부모 컨테이너 내에서 기본 크기가 컨테이너의 경계를 초과할 때 다른 줄로 감싸질지를 제어합니다.

Wraps가 부모 컨테이너의 경계 내에서 형제가 어떻게 분배되는지에 영향을 미치는 방식을 보여주는 다이어그램.

패딩

Padding 속성은 각 목록 항목 간의 공간 양을 결정하며, 현재 방향의 컨테이너 크기의 비율 (스케일) 또는 픽셀 크기와 유사한 정적 간격 (오프셋)으로 설정됩니다.

플렉스 레이아웃

UIListLayout플렉스를 통합하는 것은 목록 항목을 동일하게 채우거나 분배하거나 정렬/늘리기 위해 강력한 방법입니다. 또는 가변 공간에 걸쳐 특정 항목을 플렉스 하는 것도 가능합니다.

동일한 채우기 또는 분배

목록 레이아웃의 채우기 방향Horizontal로 설정되면, HorizontalFlex 속성은 부모 컨테이너에서 여분의 수평 공간을 분배하는 방법을 지정합니다. 유사하게, 채우기 방향이 Vertical로 설정되면, VerticalFlex 속성은 여분의 수직 공간을 분배하는 방법을 지정합니다.

UIListLayout 예시로 각 HorizontalFlex 옵션이 형제 UI 개체의 크기와 간격에 미치는 영향을 보여줍니다.

HorizontalFlex의 실용적인 사용 사례 중 하나는 탭 창 인터페이스로, 플렉스는 탭 수에 관계없이 탭 바를 동일하게 채웁니다. 이 경우, 개발자가 정의한 너비 설정 없이 자동으로 각 탭의 너비를 계산하고 탭 수가 변할 때 자동으로 조정하므로 플렉스를 사용하는 것이 가장 쉽습니다.

항목 선 정렬

ItemLineAlignment 속성은 선 내에서의 형제들의 교차 방향 정렬을 정의하여, 폭/높이가 다른 개체를 정렬하거나 폭/높이가 작은 개체가 전체 선을 채우도록 할 수 있습니다.

수평 채우기 방향에서의 ItemLineAlignment 옵션의 예.

ItemLineAlignment의 실용적인 사용 사례 중 하나는 불균형한 크기의 타일 시퀀스를 늘려서 전체 행을 채우는 것입니다 (Stretch), 레이아웃을 더 통일감 있게 만듭니다.

상이한 내용 높이를 가진 타일들이 불균형하고 층이 엇갈린 레이아웃을 형성합니다.

개별 항목 플렉스

전체 레이아웃을 플렉스하는 것은 강력한 유틸리티이지만, 특정 레이아웃은 개별 항목 플렉스에 더 적합합니다. 이러한 레이아웃에서는 목록의 일부 요소가 핵심 크기를 유지하는 반면 다른 항목은 가변 공간을 채우도록 플렉스됩니다. 실용적인 사용 사례 중 하나는 양쪽 끝에 균일한 라벨이 있는 슬라이더 바 위젯과 전체 너비를 채우는 유연한 슬라이더 바입니다.

UIListLayout의 제어 아래 특정 GuiObject에 적용된 UIFlexItem의 예.

특정 목록 항목을 유연하게 설정하려면, 유연한 항목의 자식으로 UIFlexItem을 삽입한 다음, 그 FlexMode 속성을 Fill, Grow, Shrink, 또는 Custom으로 설정하십시오.

UIListLayout의 제어 아래 GuiObject에 부모가 된 UIFlexItem의 예시 계층 구조.
©2026 Roblox Corporation. Roblox 및 Roblox 로고, 'Powering Imagination'은 미국 및 기타 국가 내 당사의 등록 및 미등록 상표입니다.