API
ColorScaleOptions

ColorScaleOptions extends ScaleOptions

맵 area 등에 표시되는 색상 범위를 표시한다.

Options

align: 'center' | 'left' | 'right'

수평 배치.
값을 지정하지 않으면, 기본값이 location'body'일 때는 'left', 'left', 'right'일 때는 'center'이다.

  • 'center' 영역 가운데로 정렬한다.
  • 'left' 왼쪽으로 정렬한다.
  • 'right' 오른쪽으로 정렬한다.

default :undefined

backgroundStyle: SVGStyles | string (opens in a new tab)

배경 스타일 셋. 배경 색상 및 경계선 스타일을 지정할 수 있다.

default :undefined

barLength: string (opens in a new tab) | number (opens in a new tab)

bar 길이.
수평으로 표시될 때 bar의 너비, 수직일 때는 높이가 된다. 숫자로 지정하면 pixel 수, '%'로 지정하면 scale이 표시될 수 있는 최대 크기에 대한 백분율로 설정된다.

default :undefined

barWidth: number (opens in a new tab)

scale bar 폭.
수평으로 표시될 때 bar의 높이, 수직일 때는 너비가 된다.

default :12

colors: Array (opens in a new tab)<ColorStop>

단계별 색상 분포를 지정한다.
둘 이상의 색상으로 이 속성이 지정되면 minColor, maxColor 속성은 무시된다. 또, steps가 지정되면 각 step에 지정된 색 범위가 우선 적용된다.

default :undefined

display: 'both' | 'legend' | 'scale'

true로 지정하면 scale view 대신, color step들을 legend view의 항목들로 표시한다.

  • 'both' scale bar와 legend에 동시 표시한다.
  • 'legend' legend 항목들로 표시한다.
  • 'scale' scale bar로 표시한다.

default :undefined

gap: number (opens in a new tab)

이 scale과 chart body 등과의 간격을 픽셀 단위로 지정한다.

default :8

integralSteps: boolean (opens in a new tab)

minValue, maxValue로 지정한 값이나, 계산된 최소/최대 값을 기준으로 steCount 속성 등에 따라 정수 배수로 분리한다.
steps가 지정되면 이 속성은 무시된다.

default :undefined

layout: 'auto' | 'horizontal' | 'vertical'

  • 'auto' color scale이 차트 좌우에 배치되면 item들을 수직으로 배치하고, color scale이 차트 상하에 배치되면 item들을 수평으로 배치한다.
  • 'horizontal' item들을 수평으로 배치한다.
  • 'vertical' item들을 수직으로 배치한다.

default :undefined

location: 'body' | 'bottom' | 'left' | 'right' | 'top'

scale 표시 위치.

  • 'body' 차트 본체 영역 내부에 표시한다.
  • 'bottom' 차트 본체 아래 표시한다.
  • 'left' 차트 본체 왼쪽에 표시한다.
  • 'right' 차트 본체 오른쪽에 표시한다.
  • 'top' 차트 타이틀 아래 표시한다.

default :undefined

logBase: number (opens in a new tab)

steps가 지정되지 않고, 2 이상의 값으로 지정하면, 데이터포인트 값들을 이 속성값을 base로 하는 log 값으로 변환해서 표시한다.

default :undefined

marker: ColorScaleMarkerOptions

현재 선택된 데이터포인트의 색상의 위치를 표시하는 marker 설정 옵션.

default :undefined

maxColor: string (opens in a new tab)

최대값 쪽 color.
colors를 지정하면 이 속성은 무시된다. 또, steps가 지정되면 각 step에 지정된 색 범위가 우선 적용된다. 지정하지 않으면 'black'로 적용된다.

default :'#000'

maxValue: number (opens in a new tab)

기준 최대값.
이 값을 지정하지 않고 series가 설정되면 그 시리즈의 최대값을 사용한다.

default :undefined

minColor: string (opens in a new tab)

최소값 쪽 color.
colors를 지정하면 이 속성은 무시된다. 또, steps가 지정되면 각 step에 지정된 색 범위가 우선 적용된다. 지정하지 않으면 'white'로 적용된다.

default :'#fff'

minValue: number (opens in a new tab)

기준 최소값.
이 값을 지정하지 않고 series가 설정되면 그 시리즈의 최소값을 사용한다.

default :undefined

name: string (opens in a new tab)

default :undefined

nullColor: boolean (opens in a new tab)

default :undefined

nullLength: string (opens in a new tab) | number (opens in a new tab)

default :undefined

offsetX: number (opens in a new tab)

범례와 body 혹은 차트 경계 사이의 수평 간격.

default :0

offsetY: number (opens in a new tab)

범례와 body 혹은 차트 경계 사이의 수직 간격.

default :0

series: string (opens in a new tab)

minValuemaxValue를 지정하지 않는 경우 범위 기준값을 계산할 시리즈의 이름.
이 속성을 지정하지 않으면 첫 번째 map 시리즈의 범위를 계산한다.

default :undefined

showNull: boolean (opens in a new tab)

default :undefined

stepCount: number (opens in a new tab)

1 이상 지정한 값으로 scale을 구분해서 표시한다.
steps가 지정되면 이 속성은 무시된다.

default :undefined

stepLine: ColorScaleStepLineOptions

default :undefined

steps: Array (opens in a new tab)<ColorScaleStep>

명시적으로 색상 스텝들을 지정한다.
이 속성이 지정되면 stepMode를 포함, step 관련된 속성들이 모두 무시된다. 가능한 연속된 값 배치로 지정해야 한다. 겹치는 경우 나중에 지정된 step이 우선하고, 어느 step에도 포함되지 않는 값일 경우 series 기본 색상이 적용된다.

default :undefined

style: SVGStyles | string (opens in a new tab)

스타일셋 혹은 class selector.

default :undefined

tick: ColorScaleTickOptions

default :undefined

verticalAlign: 'bottom' | 'middle' | 'top'

수직 배치.
값을 지정하지 않으면, 기본값이 location'body'일 때는 'top', 'top', 'bottom'일 때는 'middle'이다.

  • 'bottom'
  • 'middle'
  • 'top'

default :undefined

visible: boolean (opens in a new tab)

표시 여부.

default :true