PivotIconOverlayOptions extends NormalizedOverlayOptions

Icon overlay 옵션.

값 범위를 iconSet의 아이콘 개수만큼 자동 N등분하여 각 구간에 아이콘을 매핑한다. 임의 조건에 따라 아이콘을 표시하려면 PivotHighlightOptions의 style.icon을 사용한다.

databar와 같은 셀에 동시 적용할 수 없다 (databar가 우선).

Options

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

overlay를 적용할 셀 타입.

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

default: 'value'

See Also

CellScope

color: string (opens in a new tab) | Array (opens in a new tab)<string (opens in a new tab)>

아이콘 색상. colorable 아이콘에만 의미.

• 단일 문자열: 모든 아이콘 같은 색상
• 배열: 인덱스별 색상 미지정 시 셀의 텍스트 색상을 따른다.

default: undefined

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

divideMode: 'percent' | 'percentile' | 'value'

경계값(thresholds) 해석 방식 및 자동 N등분 기준. 기본 'percent'. thresholds 미지정 시에는 모든 모드가 자동으로 균등 N등분한다.

default: undefined

See Also

IconDivideMode

gap: number (opens in a new tab)

아이콘과 텍스트 간격(px).

default: 2

iconOnly: boolean (opens in a new tab)

true면 아이콘만 표시하고 값 텍스트를 숨기다.

default: undefined

iconSet: string (opens in a new tab)

아이콘 세트 이름. 빌트인(PivotIconSet) 또는 등록된 이름.

default: 'arrows-3'

iconSize: number (opens in a new tab)

아이콘 크기(px). 기본 14.

default: undefined

inclusive: boolean (opens in a new tab)

경계값 비교 방식.

• true(기본) : value >= threshold 이면 해당 슬롯에 포함.
• false : value > threshold 이면 해당 슬롯에 포함 (경계값 자체는 아래 슬롯).

default: true

placement: 'auto' | 'start' | 'end' | 'left' | 'right'

아이콘 배치.

default: 'auto'

reversed: boolean (opens in a new tab)

값을 정렬 역순으로 매핑. 기본 false. true면 큰 값이 0번째 아이콘, 작은 값이 마지막 아이콘이 된다.

default: undefined

thresholds: Array (opens in a new tab)<number (opens in a new tab)>

구간 경계값 (오름차순). 지정하지 않으면 divideMode 기준으로 균등 N등분한다.

• divideMode: 'percent' 이면 0~100 사이 백분율 값. 예: [33, 67]
• divideMode: 'percentile' 이면 0~100 백분위수. 예: [33, 67]
• divideMode: 'value' 이면 실제 데이터 값. 예: [1000, 5000]

길이는 (아이콘 수 - 1)이어야 한다.

default: undefined

visible: boolean (opens in a new tab)

표시 가능 여부.

default: true