CategoryAxis extends Axis
카테고리 축 모델.
type
은 'category'
이고,
설정
모델은 CategoryAxisOptions
이다.
Properties
crosshair: Crosshair
readonly
Crosshair 모델.
직선 또는 bar 형태로 축 위의 마우스 위치를 표시한다.
default :undefined
grid: AxisGrid
readonly
축 그리드 설정 모델.
tick의 위치에 수평 혹은 수직선으로 plot 영역을 구분 표시한다.
default :undefined
label: AxisLabel
readonly
축 label 설정 모델.
default :undefined
line: AxisLine
readonly
축 선 모델
default :undefined
name: string
(opens in a new tab) readonly
축 이름.
default :undefined
options: CategoryAxisOptions
readonly
차트를 생성할 때나 updateOptions
등을 통해 이 모델 객체에 설정된 옵션 값들과
기본 설정값들이 포함된 원본 설정 객체(복사본이 아니다).
리턴된 객체의 속성값들을 가져올 수 있지만,
속성들을 직접 수정하는 것은 권장되는 방법이 아니다.
updateOptions
나 updateOption
등을 사용해서 옵션들을 변경해야 한다.
default :undefined
scrollBar: AxisScrollBar
readonly
축 스크롤바 모델.
default :undefined
sectorLine: AxisSectorLine
readonly
부채꼴 polar 좌표계의 X 축일 때 원호의 양 끝과 중심에 연결되는 선분들의 설정모델.
startAngle
, totalAngle
을 참조한다.
default :undefined
tick: CategoryAxisTick
readonly
축에 표시되는 tick 위치와 표시 마크에 관한 설정 모델.
default :undefined
title: AxisTitle
readonly
축 타이틀 모델
default :undefined
visible: boolean
(opens in a new tab)
표시 여부.
설정 옵션의 visible 값을 그대로 return하는 것이 아니라,
undefined나 null 등으로 지정하는 경우 모델의 상태에 따라 true나 false로 해석될 수 있다.
설정의 경우 updateOption
으로 지정하는 것과 동일하다.
model.updateOption('visible', value);
model.updateOptions({
visible: value
});
default :undefined
xy: 'x'
| 'y'
readonly
축 방향.
default :undefined
Methods
clearOptions(render?): CategoryAxis
updateOptions
나 updateOption
등을 통해 설정된 모든 옵션 값들을 제거하거나,
전역 기본값이 존재하는 경우 그 값으로 되돌린다.
Parameter | Type | Description |
---|---|---|
render=true | boolean (opens in a new tab) | true(기본값)으로 지정하면 차트를 다시 그린다. |
return 객체 자신.
destroy(): null
객체가 소유한 참조 등을 해제하고 null을 리턴한다.
model = model.destroy();
return null
isEmpty(): boolean
(opens in a new tab)
시리즈 연결 여부.
연결된 시리즈가 하나도 없으면 true.
isZoomed(): boolean
(opens in a new tab)
zoom 상태인 지 확인한다.
return zoom 상태이면 true.
loadOptions(source): CategoryAxis
기존 옵션 값들을 모두 제거하고 source에 지정한 값들로 새로 구성한다.
chart.legend.loadOptions({
visible: true,
location: 'right
})
Parameter | Type | Description |
---|---|---|
source | CategoryAxisOptions | 설정 정보 객체 혹은 단일값. |
return 이 객체 자신.
removeOption(prop, render?): CategoryAxis
지정한 속성에 설정한 값이 있으면 제거하고, 기본값으로(있다면) 되돌린다.
Parameter | Type | Description |
---|---|---|
prop | keyof (opens in a new tab) CategoryAxisOptions | 속성 이름. |
render=true | boolean (opens in a new tab) | true(기본값)으로 지정하면 차트를 다시 그린다. |
return 객체 자신.
resetZoom(): void
(opens in a new tab)
zoom 상태를 제거한다.
saveOptions(recursive?): any
(opens in a new tab)
이 모델 객체에 설정된 전역 기본값과 다른 옵션 값들이 포함된 사본 객체로 리턴한다.
options
객체에는 전역 기본값들도 포함되어 있다.
const options = chart.legend.saveOptions();
console.log(options);
Parameter | Type | Description |
---|---|---|
recursive=true | boolean (opens in a new tab) | 기본값 true이면 하위 모델의 옵션들도 포함된다. |
return 옵션 사본 객체.
toggleOption(prop, render?): CategoryAxis
Boolean 타입의 설정값을 변경한다.
지정 가능한 설정 값 목록은 Configuration API 페이지
에서 확인할 수 있다.
chart.getSeries('ser02').toggleOption('visible');
Parameter | Type | Description |
---|---|---|
prop | keyof (opens in a new tab) CategoryAxisOptions | 설정 속성 이름. |
render=true | boolean (opens in a new tab) | true로 지정하면 chart를 다시 그린다. false로 지정하고 여러 설정 후에 render 를 호출해서 다시 그리게 할 수도 있다. 기본값은 true. |
return 객체 자신.
updateOption(prop, value, render?): CategoryAxis
하나의 속성 값을 설정한다.
여러 속성들을 한꺼번에 변경할 때는 updateOptions
를 사용한다.
Parameter | Type | Description |
---|---|---|
prop | keyof (opens in a new tab) CategoryAxisOptions | |
value | any (opens in a new tab) | |
render=true | boolean (opens in a new tab) | true로 지정하면 설정 후 차트를 다시 그린다. |
return 객체 자신.
updateOptions(source?, render?): CategoryAxis
하나 이상의 option 설정을 하고,
차트가 다시 그려지도록 한다.
chart.legend.updateOptions({
gap: 10,
lineGap: 20
});
권장하는 방식은 아니지만, options
의 값들을 직접 수정한 후에도 이 메소드를 호출해서
내부의 값들이 다시 계산되도록 해야 한다.
chart.legend.options.gap = 10,
chart.legend.options.lineGap = 20,
chart.legend.updateOptions();
Parameter | Type | Description |
---|---|---|
source | CategoryAxisOptions | 설정 정보 객체 혹은 단일값. |
render=true | boolean (opens in a new tab) | true로 지정하면 설정 후 차트를 다시 그린다. |
return 객체 자신.
zoom(start, end, minSize?): boolean
(opens in a new tab)
zoom 상태를 새로운 범위로 변경한다.
Parameter | Type | Description |
---|---|---|
start | number (opens in a new tab) | 표시할 시작 값. |
end | number (opens in a new tab) | 표시할 끝 값. |
minSize=NaN | number (opens in a new tab) | 최소 범위 |
return zoom 상태가 변경되면 true.