# UIListLayout

UIListLayout : `UIGridStyleLayout`

## Overview

형제 UI 요소들을 부모 UI 영역 안에서 가로 또는 세로 방향으로 자동 배치하는 레이아웃입니다. 배치 방향은 FillDirection 설정에 따라 결정되며, 리스트 형태로 UI를 정돈할 때 활용됩니다.

UIListLayout은 **클라이언트 환경**에서만 제어할 수 있습니다.

## Properties

### Padding

`UDim`

UI 요소들 사이의 간격을 정의합니다.

간격은 부모 컨테이너 크기에 비례해 자동으로 조정되는 비율 기반(Scale) 또는 언제나 동일한 크기를 유지하는 고정값 기반(Offset) 중 원하는 방식으로 지정할 수 있습니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local UIListLayout = Frame:WaitForChild("UIListLayout")

UIListLayout.Padding = UDim.new(0, 20)
```

### Wraps

`boolean`

부모 UI 영역 안에서 요소들을 나열할 때, 컨테이너의 가용 공간을 넘어서면 새 줄로 넘어가도록 할지를 지정합니다.

예를 들어 가로 방향 배치에서 요소들의 너비 합이 부모의 너비를 초과하면 아래 줄로 이동해 배치가 이어지고, 세로 배치에서는 높이를 초과할 때 다음 열로 넘어가는 방식으로 작동합니다.

#### Code Samples

```lua
local ScreenGui = script.Parent
local Frame = ScreenGui:WaitForChild("Frame")
local UIListLayout = Frame:WaitForChild("UIListLayout")

UIListLayout.Wraps = true
```

## Methods

## Events

## See also

{% content-ref url="/pages/K1g0tEWDJhh6a6E4UURk" %}
[GUI](/korean/manual/studio-manual/gui.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/classes/uilistlayout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.