PivotDataBarOptions extends ValueRangeOverlayOptions

데이터 막대 옵션 인터페이스.

• 값의 크기에 비례하는 막대를 셀 배경에 표시한다.
• 양수/음수 모두 표시할 수 있으며, 양방향/로그 스케일 등 다양한 옵션을 제공한다.
• compareScope 옵션으로 같은 행/열/그룹 내에서 비교할지, 전체 기준으로 비교할지 선택할 수 있다.
• cellScope 옵션으로 상세 셀에만 적용할지, 소계/총계에도 적용할지 선택할 수 있다.
• heatmap과 달리 색상 대신 막대의 길이로 값을 시각화하므로, 색맹인 사용자도 인식하기 쉽다.

Options

visible: boolean (opens in a new tab)

표시 가능 여부.

default: true

cellScope: 'value' | 'subtotal' | 'total' | 'all' | Array (opens in a new tab)<'value' | 'subtotal' | 'total'>

overlay를 적용할 셀 타입.

기본값은 'value'(상세 셀에만 적용). 소계/총계는 값이 커서 정규화 기준을 왜곡하기 쉬우므로 주의가 필요하다. 소계에도 적용하려면 보통 compareScope: ['level', ...]을 같이 쓴다.

default: 'value'

See Also

CellScope

compareScope: 'all' | 'row' | 'column' | 'level' | 'rowGroup' | 'columnGroup' | Array (opens in a new tab)<'row' | 'column' | 'level' | 'rowGroup' | 'columnGroup'>

값을 비교(정규화)할 범위.

어느 셀들을 "한 그룹"으로 보고 해당 그룹의 min/max로 정규화할지 결정한다. 이 값에 따라 같은 셀의 색상/막대 폭이 달라진다.

배열로 조합 가능하며, 조합된 축들의 교차 그룹별로 분리된다.

default: 'all'

See Also

CompareScope

boundsMode: 'auto' | 'value' | 'percent' | 'percentile'

minValue/maxValue(+ heatmap midValue) 해석 방식. overlay의 모든 경계 옵션은 이 한 가지 방식으로 통일 해석된다.

default: 'auto'

See Also

ValueBoundsMode

maxValue: number (opens in a new tab)

최대값. boundsMode에 따라 해석된다. boundsMode: 'auto'이거나 미지정이면 데이터의 실제 최대값이 사용된다.

default: undefined

minValue: number (opens in a new tab)

최소값. boundsMode에 따라 해석된다. boundsMode: 'auto'이거나 미지정이면 데이터의 실제 최소값이 사용된다.

default: undefined

outOfRange: 'clamp' | 'hide'

사용자가 설정한 minValue/maxValue 범위를 벗어난 값의 처리 방식.

• 'clamp' (기본): 범위 경계값으로 클래핑해서 overlay를 계속 그린다 (heatmap: 끝색, dataBar: 0%/100%).
• 'hide' : 범위 밖 셀은 overlay를 적용하지 않는다 (값 자체는 표시).

boundsMode: 'auto'이거나 min/max를 지정하지 않으면 범위 밖 셀이 존재할 수 없으므로 이 옵션은 무의미하다.

default: 'clamp'

logBase: number (opens in a new tab)

로그 스케일 밑(base).

• > 1 이면 해당 밑의 로그 스케일로 정규화한다 (예: 2, Math.E, 10).
• <= 1 이거나 미지정/비유한값이면 무시되어 선형 스케일로 처리된다. (base = 1은 정의 불가, 0 < base < 1은 정규화 방향이 뒤집혀 의미가 없다.)

default: 10

barOnly: boolean (opens in a new tab)

막대만 표시 여부.
true로 지정하면 셀의 값(텍스트)은 숨기고 막대만 표시한다. 기본값은 false로, 값과 막대를 함께 표시한다.

default: false

color: string (opens in a new tab)

양수 색상.

default: '#638ec6'

alpha: number (opens in a new tab)

바 투명도.
0 ~ 1 사이의 값으로, 0이면 완전히 투명하게 표시된다.

default: 0.4

negativeColor: string (opens in a new tab)

음수 색상.

default: '#ff6347'

borderColor: string (opens in a new tab)

테두리 색상.
설정하지 않으면 경계선이 표시되지 않는다. 또, 양수와 음수 모두 같은 색상이 사용된다.

default: undefined

gradient: boolean (opens in a new tab)

그라데이션 표시 여부
. 기본값은 false로, 단색으로 표시한다.

default: false

bidirectional: boolean (opens in a new tab)

양방향 표시 여부.
true로 지정하면 기준값 보다 크면 오른쪽으로, 작으면 왼쪽으로 표시한다. reversed가 true로 지정된 경우에는 반대로 표시한다. 기본값은 false로, 양수와 음수 모두 오른쪽으로 표시한다.

default: undefined

reversed: boolean (opens in a new tab)

true로 지정하면 양방향 표시일 때 기준값 보다 크면 왼쪽으로, 작으면 오른쪽으로 표시한다.

default: undefined

baseValue: number (opens in a new tab)

양방향 표시일 때 기준값.

default: 0

barHeight: number (opens in a new tab)

막대 세로 비율. 0~1 사이 값(셀 높이 대비) 또는 'auto'(전체 높이). 기본값은 1로, 셀 전체 높이를 채운다.

default: 0.8

axis: DataBarAxisOptions

양방향 표시일 때 축 설정 옵션.

default: undefined

barPicker: (cell: IPivotValueCellInfo, stats: ScopedStats) => number (opens in a new tab)

셀별 막대 비율을 직접 결정하는 콜백. 정의되면 boundsBy/minValue/maxValue/logBase/baseValue 기반 정규화·방향 판정을 전부 우회한다.

• 반환값은 -1 ~ 1 사이의 부호 있는 비율. 부호가 방향(음수 → negativeColor), 절대값이 길이. 범위를 벗어나면 클램프된다.
• undefined 반환 → 해당 셀에 한해 기본 경로로 폴백.

stats는 overlay 자신의 cellScope/compareScope로 prepare된 분포 통계.

default: undefined