# 목록

## Content



```목록``` 보고서 항목은 [텍스트 상자](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Visualizers/TextBox) 또는 자유 형식 레이아웃으로 정렬된 [이미지](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Visualizers/Image) 등 [데이터 시각화 도우미](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Visualizers)가 포함된 일련의 섹션을 생성하여 바인딩된 데이터를 시각화하는 [데이터 영역](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Regions)입니다.

일반적으로 ```목록```은 [중첩된 데이터 영역](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Regions#nested-data-regions)으로 사용되어 단일 데이터 레코드 내에서 항목 컬렉션을 표시합니다. 예를 들어, [표 내의 목록 데모](/activereportsjs/demos/Reports/NestedDataRegionsDemo/purejs)에서는 제품 [표](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Regions/Table) 내에서 ```목록```을 사용하여 가격 내역을 표시합니다. 

### 목록 추가

[도구 상자](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Designer-Interface#toolbox)에서 해당 항목을 두 번 클릭하거나 [표 셀](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Regions/Table#table-cells)과 같은 부모 컨테이너로 끌어 놓아 보고서에 ```목록```을 추가할 수 있습니다.

### 목록 디자이너

```목록``` 디자이너는 [데이터 집합 필터](/activereportsjs/docs/v2.2/ReportAuthorGuide/Databinding#data-set-filters)와 [데이터 영역 필터](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Regions#common-properties)를 통과한 각 [바인딩된 데이터 집합](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Regions#data-set-name) 레코드에 대해 반복되는 ```섹션```의 내용 및 스타일을 결정합니다. 예를 들어, [표 내 목록](/activereportsjs/demos/Reports/NestedDataRegionsDemo/purejs)의 ```가격 내역``` 목록에는 ```ProductListPriceHistories``` 데이터 집합 레코드의 날짜 기간과 가격을 표시하는 [텍스트 상자](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Visualizers/TextBox)가 2개 포함되어 있습니다. 

[기본 보고서 항목 속성](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Common-Properties#base-properties)과 [데이터 영역 속성](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Data-Regions#common-properties)으로 구성된 일반적인 목록 구성은 [속성](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Designer-Interface#properties-panel) 패널의 ```섹션``` 속성과 결합됩니다.

### 섹션 구성

```섹션``` 구성에는 [공통 스타일 속성](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Common-Properties#style-properties), [표시 여부](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Common-Properties#visibility), [페이지 나누기](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Common-Properties#page-break)와 다음 특정 속성이 포함되어 있습니다.

* ```공백 사용``` 플래그는 콘텐츠가 사용하는 것보다 여유 공간이 더 있는 경우 섹션 인스턴스가 공백을 제거해야 할지 여부를 나타냅니다.
* ```함께 유지``` 플래그는 섹션 인스턴스가 맞는 경우 항상 단일 페이지에 나타나도록 합니다.

### 목록 그룹화

섹션이 그룹화 값당 한 번 나타나도록 ```목록``` 내에서 데이터 레코드를 그룹화할 수 있습니다. 이 속성은 계층적 데이터 구조를 표시하는 데 유용할 수 있습니다. 이러한 접근 방식의 예는 [중첩된 목록의 예](/activereportsjs/demos/Reports/NestedDataRegions/purejs)에서 찾을 수 있습니다. 그룹 구성에는 다음 속성이 포함됩니다.

* ```그룹 이름```은 그룹 ```ID```입니다.
* ```그룹 식```은 [바운딩된 필드 참조](/activereportsjs/docs/v2.2/ReportAuthorGuide/Expressions/references#data-set-fields)의 [컬렉션](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Common-Properties#collection) 또는 고급 식입니다. 그룹 식의 고유한 값은 ```그룹화 값```을 생성합니다. 
* ```레이블``` [식](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Items/Common-Properties#expression)은 [보고서 맵](/activereportsjs/docs/v2.2/ReportAuthorGuide/Interactivity#report-map)에 있는 그룹화 값 링크의 텍스트를 결정합니다. [중첩된 목록의 예](/activereportsjs/demos/Reports/NestedDataRegions/purejs)에서는 이 속성을 사용합니다.
* [필터 편집기](/activereportsjs/docs/v2.2/ReportAuthorGuide/Report-Designer-Interface#filters-editor)에서는 특정 그룹화 값을 필터링할 수 있습니다. 예를 들어, ```중첩된 목록의 예``` 출력에서 ```Nintendo``` 게시자를 제외하려는 경우 ```게시자``` 목록의 ```그룹```에 대해 다음 필터를 추가할 수 있습니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/4ed8c11f-8d09-4226-9c37-dd4595797443/reportauthor-guide/List/group-filter.png)

* ```새 섹션``` 플래그는 각 그룹화 값에 페이지 번호 매기기 적용 여부를 결정합니다. 자세한 내용은 [전역 참조](/activereportsjs/docs/v2.2/ReportAuthorGuide/Expressions/references#page-numbering) 문서를 확인하십시오.