PivotSeriesOptions extends PivotItemOptions

피벗 시리즈 설정 옵션.
시리즈(series)는 소계/총계 옆에 하나의 셀로 끼어들어, 그 그룹에 속한 값들을 스파크라인·히스토그램 같은 작은 그래프로 보여주는 셀이다.
소계/총계는 여러 값을 하나의 숫자로 합쳐서 표시하지만, 시리즈는 값들을 합치지 않고 나열된 그대로를 그래프 형태로 보여준다. 예를 들어 분기 소계 자리에 "그 분기에 속한 월별 매출"을 막대 스파크라인으로 그려, 합계 숫자만으로는 안 보이는 추세를 한눈에 보여줄 수 있다.
시리즈 셀은 표의 열/행 정렬 규칙을 따르지 않고 지정한 위치에 한 칸만 차지한다. 또한 새로 집계하지 않고 피벗이 이미 계산해둔 값만 읽어 그리므로, 정렬·필터 같은 기존 기능에 영향을 주지 않는다.

dimension을 지정하면 해당 그룹의 소계에, 지정하지 않으면 총계 위치에 시리즈 셀이 표시된다. 표시 방식은 renderer로 결정하며, 미지정 시 텍스트 렌더러가 사용된다.

Options

visible: boolean (opens in a new tab)

표시 여부.

default: true

style: string (opens in a new tab) | Partial (opens in a new tab)<Pick (opens in a new tab)<CSSStyleDeclaration (opens in a new tab), ...>>

스타일셋 혹은 class selector.

default: undefined

dimension: string (opens in a new tab)

소계에 표시되는 시리즈인 경우 해당 시리즈가 속한 그룹의 dimension을 지정한다.
예를 들어, column 시리즈에서 dimension이 'country'인 경우, 각 국가별 소계에 시리즈 셀이 표시된다. dimension을 지정하지 않으면 총계 시리즈 셀이 표시된다.

default: undefined

measure: string (opens in a new tab)

표시할 측정값.
지정하지 않으면 첫 번째 value 필드의 measure가 사용된다.

default: undefined

axis: 'row' | 'column'

전체 요약 시리즈 축
. level을 지정하지 않으면 전체 요약 시리즈가 되는데 이 경우 전체 요약이 표시되는 축.
전체 요약 시리즈가 아닌 경우 이 속성은 무시되고 dimension이 지정된 그룹의 소계/총계 축이 사용된다.

default: 'column'

position: 'start' | 'end' | 'total'

시리즈 셀 표시 위치.
start로 설정하면 시리즈 셀을 그룹의 첫 번째 위치에 표시하고, end로 설정하면 마지막 위치에 표시한다. auto로 설정하면 소계/총계 위치에 표시된다. dimension이 지정되지 않은 전체요약인 경우 이 속성은 무시되고, order 속성으로 시리즈 셀의 위치가 결정된다.

default: 'auto'

order: 'before' | 'after'

소계/총계 셀과 시리즈 셀의 표시 순서. before로 설정하면 시리즈 셀을 소계/총계보다 먼저 표시하고, after로 설정하면 소계/총계 다음에 표시한다.

default: 'before'

label: string (opens in a new tab)

시리즈 레이블.

default: undefined

width: number (opens in a new tab)

컬럼 시리즈인 경우 열 너비(px).

default: 100

renderer: TextSeriesRendererOptions | SparkBarSeriesRendererOptions | SparkLineSeriesRendererOptions | SparkWinlossSeriesRendererOptions(typeof TextSeriesRendererType)(typeof SparkBarSeriesRendererType)(typeof SparkLineSeriesRendererType)(typeof SparkWinlossSeriesRendererType)

유형에 따른 렌더러 옵션.
유형 문자열로 지정하면 해당 유형의 렌더러 옵션이 기본값으로 사용된다. 예를 들어, 'bar'로 지정하면 막대 차트 렌더러가 기본 옵션으로 사용된다.
지정하지 않으면 텍스트 렌더러로 표시한다.

default: 'text'