문서 › 레퍼런스

옵션

createChart 에 넘기는 모든 옵션.

data 말고는 모두 선택입니다. 아무것도 주지 않으면 카드 모양의 선 차트, 문서 언어(없으면 한국어), 페이지를 따라가는 테마로 그립니다.

종류와 데이터

옵션	기본값	설명
`type`	'line'	`'line' \| 'area' \| 'bar' \| 'pie' \| 'donut' \| 'scatter' \| 'radar' \| 'gauge'`
`data`	(필수)	`{ labels?, series }` — 데이터 형식

옵션	기본값	설명
`eyebrow`	-	제목 위 작은 글 (대문자로 표시)
`title`	-	제목. 요약·표 제목·파일 이름에도 쓰임
`subtitle`	-	제목 아래 회색 글
`value`	-	큰 대표 숫자. 숫자면 쉼표·`prefix`·`unit` 을 붙임
`delta`	-	증감 배지. 숫자면 퍼센트, 문자열이면 그대로
`deltaUpIsGood`	true	오르면 좋은 지표인지
`deltaColors`	'semantic'	`'semantic'`(좋음 초록·나쁨 빨강) 또는 `'korea'`(오름 빨강 ▲·내림 파랑 ▼)
`deltaLabel`	-	배지 옆 글, 예: '전월 대비'
`footnote`	-	차트 아래 작은 글, 예: '단위: 백만원'
`description`	-	스크린리더가 자동 요약 앞에 읽는 설명
`skin`	'card'	`'card' \| 'plain' \| 'sparkline'`

옵션	기본값	설명
`xAxis / yAxis`	-	`{ title, min, max, format, ticks, step, integer, reverse, grid, type, beginAtZero, labels }` — 아래 표
`y2Axis`	-	오른쪽 y축. 시리즈에 `axis: 'right'` 가 있을 때만 생김. 같은 옵션 + `unit`, `prefix`
`legend`	시리즈 2개 이상이면 위	`boolean \| 'top' \| 'bottom' \| 'right'`
`tooltip`	true	`boolean \| { format(value, ctx) }`

옵션	기본값	설명
`numberFormat`	ko: 'korean', 그 외 'compact'	`'korean' \| 'compact' \| 'comma' \| 'percent' \| (v) => string`
`scale`	-	축 눈금을 이 수로 나눔 (1000000 + 백만원)
`unit`	-	값 뒤 단위
`prefix`	-	값 앞 기호
`decimals`	최대 2	툴팁·라벨 소수 자리
`dateFormat`	'auto'	날짜 패턴, 예: `'M월'`, `'YYYY.MM.DD'`
`timeZone`	실행 환경	날짜를 읽고 적는 IANA 시간대, 예: `'Asia/Seoul'` (UTC 서버의 SSR 에 필요)

옵션	기본값	설명
`colors`	-	시리즈 순서대로 색
`palette`	'default'	`'default' \| 'korea' \| 'mono'`
`negativeColor`	-	0보다 작은 막대 색
`theme`	'auto'	`'light' \| 'dark' \| 'auto'`
`language`	문서 lang, 없으면 ko	`'ko' \| 'en' \| 'ja' \| 'zh'` (`registerLocale` 로 추가)
`locale`	-	화면 문구 일부만 바꾸기

옵션	기본값	설명
`animation`	true	처음 그릴 때 애니메이션 (동작 줄이기 설정이면 꺼짐)
`zoom`	false	확대·이동
`downsample`	2,000개 넘으면 자동	선·영역의 점을 LTTB 로 이만큼 줄임. `false` 면 모두 그림. CSV·표는 원본
`annotations`	-	`{ x, y, bands }`
`exporting`	true	내려받기 단추와 ⋯ 메뉴
`table`	false	데이터 표를 보이게
`noData`	언어별 문구	그릴 값이 없을 때 문구
`group`	-	같은 이름끼리 크로스헤어 공유
`loading`	false	불러오는 중 자리 표시

옵션	기본값	설명
`onClick`	-	`(point: ChartPoint) => void`
`onReady`	-	`(chart) => void` — 만든 직후 한 번
`telemetry`	true	하루 한 번 도메인과 버전만 82chart.com 에 알림 (데이터는 보내지 않음). `false` 로 끔
`framework`	-	래퍼가 채우는 값

오른쪽 y축(y2Axis)은 시리즈에 axis: 'right' 를 줄 때만 생깁니다. 주의할 점은 콤보 차트에 있습니다.