icon

Icon overlay 옵션.

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

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

Options

visible: boolean

표시 가능 여부.

default: true

cellScope: 'value'|'subtotal'|'total'|'all'|('value'|'subtotal'|'total')[]

overlay를 적용할 셀 타입.

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

default: 'value'

compareScope: 'all'|'row'|'column'|'level'|'rowGroup'|'columnGroup'|('row'|'column'|'level'|'rowGroup'|'columnGroup')[]

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

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

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

default: 'all'

iconSet: string

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

default: 'arrows-3'

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

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

inclusive: boolean

경계값 비교 방식.

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

default: true

thresholds: number[]

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

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

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

color: string|string[]

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

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

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

아이콘 배치.

default: 'auto'

iconOnly: boolean

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

reversed: boolean

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

iconSize: number

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

gap: number

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

default: 2