API
ColorScaleOptions

ColorScaleOptions extends ScaleOptions

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

Options

align: Align

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

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

default :undefined

background: MapWidgetBackgroundOptions

범례나 scale의 배경 설정 옵션.

default :undefined

barLength: PercentSize

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

default :'40%'

barWidth: number (opens in a new tab)

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

default :12

display: ColorScaleDisplay

컬러 스케일 표시 방식.
'scale'은 scale bar로, 'legend'는 scale bar 대신 color step들을 legend 항목들로, 'both'는 양쪽 모두에 표시한다.

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

default :'scale'

footer: MapWidgetCaptionOptions

범례나 scale의 footer 설정 옵션.

default :undefined

group: string (opens in a new tab)

이 위젯이 표시될 위젯 그룹 이름.
그룹에 포함되지 않은 위젯은 location 설정에 따라 위젯 섹션이나 body 영역에 표시된다.

default :undefined

integralSteps: boolean (opens in a new tab)

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

default :undefined

inverted: boolean (opens in a new tab)

step의 방향을 바꿔 표시한다.
true면 오른쪽에 왼쪽으로, 또는 위쪽에서 아래쪽으로 최소에서 최대값으로 흐르게 표시한다.

default :undefined

layout: ColorScaleLayout

step 항목들의 배치 방향.

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

default :'auto'

location: ChartItemLocation

범례나 scale 표시 위치.

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

default :'bottom'

logBase: number (opens in a new tab)

2 이상의 값으로 지정하면 이 속성값을 base로 하는 log 값을 기준으로 step을 생성한다.
step label은 log를 취하지 않은 원 값을 표시한다. steps가 지정된 경우 데이터 값이 log로 변환된 후 각 step의 from/to와 비교되므로, from/to 값도 log가 적용된 값으로 지정해야 한다.

default :undefined

marker: ColorScaleMarkerOptions

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

default :undefined

maxColor: string (opens in a new tab)

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

default :undefined

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

nullStep: ColorScaleNullOptions

지정되지 않은 값들을 표시하는 데 적용되는 색상을 지시하는 별도의 step 설정 옵션.

default :undefined

offsetX: number (opens in a new tab)

범례 또는 scale과 (location이 body일 때)body 또는 맵차트 경계 사이의 수평 간격.

default :0

offsetY: number (opens in a new tab)

범례 또는 scale과 (location이 body일 때)body 또는 맵차트 경계 사이의 수직 간격.

default :0

order: number (opens in a new tab)

그룹 내에서 배치 순서.
값을 지정하지 않거나 잘못 지정하면 마지막에 배치된다.

default :undefined

reversed: boolean (opens in a new tab)

Step 상자들과 tick label들의 위치를 바꿔 표시한다.
true면 label이 step 상자 왼쪽이나 위쪽에 표시된다.

default :undefined

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

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

default :undefined

solidFill: boolean (opens in a new tab)

각 step의 색상을 gradient 없이 단일 색상으로 표시한다.
스텝별로 fromColor, toColor가 지정된 경우에는 이 속성과 상관없이 gradient로 표시된다.

default :undefined

stepCount: number (opens in a new tab)

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

default :undefined

stepLine: ColorScaleStepLineOptions

Step 상자와 label 사이의 연결선 설정 옵션.

default :undefined

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

명시적으로 색상 스텝들을 지정한다.
이 속성이 지정되면 stepCount, integralSteps 등 자동 step 생성 관련 속성들이 모두 무시된다. 가능한 연속된 값 배치로 지정해야 한다. 구간이 겹치는 경우 먼저 지정된 step이 우선한다. 어느 step에도 포함되지 않는 값은 series 기본 색상으로 표시된다. 단, 스케일 최소값 이하의 값은 첫 step의 색으로, 스케일 최대값 이상의 값은 마지막 step의 색으로 표시된다.

default :undefined

style: SVGStyleOrClass

스타일셋 혹은 class selector.

default :undefined

tick: ColorScaleTickOptions

Step 상자 옆에 표시되는 label 설정 옵션.

default :undefined

title: MapWidgetCaptionOptions

범례나 scale의 타이틀 설정 옵션.

default :undefined

verticalAlign: VerticalAlign

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

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

default :undefined

visible: boolean (opens in a new tab)

표시 여부.

default :true