# pivotColumns

고유 값이 피벗의 상단 결과 열로 펼쳐질 필드 목록입니다.

Canonical: https://grid.syidax.com/ko/docs/options/pivotColumns/

<a id="meaning"></a>

## 무엇을 하는 API인가요

고유 값이 피벗의 상단 결과 열로 펼쳐질 필드 목록입니다.

Pro 기능 관련 API: Pivot

<a id="contract"></a>

## 입력과 결과의 정확한 타입

```typescript
pivotColumns: string[]
```

| 항목 | 값 |
| --- | --- |
| JavaScript 이름 | pivotColumns |
| HTML 속성 | pivot-columns |
| 기본값 | undefined |
| 입력 타입 | string[] |

<a id="usage"></a>

## 사용 흐름

이 항목은 Grid 요소의 프로퍼티에 설정합니다. 배열·객체·콜백 함수는 JavaScript로 전달하고, 변경을 반영할 때 새 배열이나 객체를 사용하세요.

<a id="recipes"></a>

## 기능별 설명과 예제

- [피벗 분석](https://grid.syidax.com/ko/docs/features/pivot.md) — 피벗은 원본 주문을 행 축·열 축·값 축으로 나누어 교차 집계표를 만듭니다. 지역별 주문 행을 접는 그룹과 달리, 고유한 상태 값 등이 새로운 결과 열로 생깁니다.