ValueRangeOverlayOptions extends NormalizedOverlayOptions

subinterfaces PivotDataBarOptions, PivotHeatmapOptions

정규화 범위(min/max)를 사용자가 명시 조정할 수 있는 overlay 옵션.
boundsBy/minValue/maxValue/logBase가 추가된다.

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