ValueRangeOverlayOptions extends NormalizedOverlayOptions
subinterfaces PivotDataBarOptions, PivotHeatmapOptions
정규화 범위(min/max)를 사용자가 명시 조정할 수 있는 overlay 옵션.
boundsBy/minValue/maxValue/logBase가 추가된다.
Options
boundsMode: 'auto' | 'value' | 'percent' | 'percentile'
minValue/maxValue(+ heatmap midValue) 해석 방식.
overlay의 모든 경계 옵션은 이 한 가지 방식으로 통일 해석된다.
default: 'auto'
See Also
cellScope: 'value' | 'subtotal' | 'total' | 'all' | Array (opens in a new tab)<'value' | 'subtotal' | 'total'>
overlay를 적용할 셀 타입.
기본값은 'value'(상세 셀에만 적용). 소계/총계는 값이 커서 정규화 기준을 왜곡하기 쉬우므로
주의가 필요하다. 소계에도 적용하려면 보통 compareScope: ['level', ...]을 같이 쓴다.
default: 'value'
See Also
compareScope: 'all' | 'row' | 'column' | 'level' | 'rowGroup' | 'columnGroup' | Array (opens in a new tab)<'row' | 'column' | 'level' | 'rowGroup' | 'columnGroup'>
값을 비교(정규화)할 범위.
어느 셀들을 "한 그룹"으로 보고 해당 그룹의 min/max로 정규화할지 결정한다. 이 값에 따라 같은 셀의 색상/막대 폭이 달라진다.
배열로 조합 가능하며, 조합된 축들의 교차 그룹별로 분리된다.
default: 'all'
See Also
logBase: number (opens in a new tab)
로그 스케일 밑(base).
> 1이면 해당 밑의 로그 스케일로 정규화한다 (예:2,Math.E,10).<= 1이거나 미지정/비유한값이면 무시되어 선형 스케일로 처리된다. (base = 1은 정의 불가,0 < base < 1은 정규화 방향이 뒤집혀 의미가 없다.)
default: 10
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'
visible: boolean (opens in a new tab)
표시 가능 여부.
default: true