API
API
Options
PivotColumnHeaderOptions

PivotColumnHeaderOptions extends PivotHeaderOptions

Options

autoWidth: boolean (opens in a new tab)

열 너비 자동 조정 여부.

default: false

autoWidthMode: 'header' | 'total' | 'both' | 'all'

자동 너비 계산에 포함할 셀 종류.

  • 'header': 헤더 셀만
  • 'total': 헤더 + 소계/총계 셀
  • 'both': 헤더 + 소계/총계 + 일반 셀(min/max 추정)
  • 'all': 'both'와 동일 (현재 모든 일반 셀 전수 측정 미지원)

default: 'both'

columnResizable: boolean (opens in a new tab)

열 너비 조정 허용 여부.

default: true

dimensionClickAction: 'none' | 'select' | 'expand' | 'selectAndExpand'

차원필드 헤더 셀 클릭 시 동작 방식.

  • 'none': 아무 동작도 하지 않는다.
  • 'select': 클릭한 셀 열이나 행의 셀들을 모두 선택한다.
  • 'expand': 클릭한 셀의 항목을 확장/축소한다.

default: 'select'

expanderVisible: boolean (opens in a new tab)

하위 항목 확장/축소 아이콘 표시 여부.

default: true

fallbackSortScope: 'all' | 'unset'

measureClickAction'sort'로 지정된 경우, 설정될 기본 정렬(fallback sort)의 적용 범위

default: 'unset'

hideSingleMeasure: boolean (opens in a new tab)

measure가 하나만 있으면 measure 행이나 열을 표시하지 않는다.

default: true

initCollapsed: boolean (opens in a new tab) | 'all'

초기 상태에서 모든 항목을 축소할지 여부.

  • true: 최상위 필드의 모든 항목을 축소
  • 'all': 모든 필드의 모든 항목을 축소
  • false: 초기 상태에서 항목을 축소하지 않음

default: false

maxColumnWidth: number (opens in a new tab)

자동 계산된 컬럼 너비의 최대값(px). 지정하면 계산 결과가 이 값보다 커도 이 값 이하로 잘린다. 사용자가 직접 지정한 너비(setColumnWidth)에는 적용되지 않는다.

default: undefined

measureClickAction: 'none' | 'select' | 'sort' | 'selectAndSort'

값필드 헤더 셀 클릭 시 동작 방식.

  • 'none': 아무 동작도 하지 않는다.
  • 'select': 클릭한 셀 열이나 행의 셀들을 모두 선택한다.
  • 'sort': 클릭한 셀 열이나 행의 셀들을 기준으로 반대 축 열이나 행의 기본 정렬(fallback sort)을 설정한다.
    클릭할 때마다 정렬 방향을 'asc''desc''none' 순으로 변경한다.

default: 'select'

minColumnWidth: number (opens in a new tab)

자동 계산된 컬럼 너비의 최소값(px). 지정하면 계산 결과가 이 값보다 작아도 이 값 이상으로 보장된다. 사용자가 직접 지정한 너비(setColumnWidth)에는 적용되지 않는다.

default: undefined

style: string (opens in a new tab) | Partial (opens in a new tab)<Pick (opens in a new tab)<CSSStyleDeclaration (opens in a new tab), ...>>

스타일셋 혹은 class selector.

default: undefined

visible: boolean (opens in a new tab)

표시 여부.

default: true