Wijmo FlexChart 툴팁 커스터마이징: 템플릿·함수로 구현하기
차트에 마우스를 올렸을 때 "1월 42000000" 같은 가공되지 않은 숫자만 보인다면, 사용자는 그 값이 얼마인지, 목표 대비 어느 수준인지 바로 알기 어렵습니다. 처음 JavaScript 차트 툴팁을 만들어 보는 개발자라면 어디서부터 손대야 할지 막막할 수 있습니다. Wijmo(위즈모) by MESCIUS(메시어스)의 FlexChart는 tooltip
속성 하나로 툴팁의 내용, 서식, 표시 시점, 위치를 모두 코드로 제어할 수 있습니다.
이 글에서는 기본 툴팁에서 출발해 템플릿 문자열, 함수, 표시 옵션까지 단계별로 다듬으며 월별 매출 차트를 완성합니다.
chart.tooltip.content
에 {seriesName}
, {x}
, {y}
같은 파라미터가 담긴 HTML 템플릿 문자열을 넣으면 툴팁 형식이 바뀝니다.{sales:n0}
처럼 데이터 필드명 뒤에 서식 코드를 붙여 천 단위 구분과 통화 서식을 적용할 수 있습니다.content
에 함수를 지정하면 HitTestInfo
객체( ht.item
, ht.series
, ht.pointIndex
)를 받아 데이터 포인트마다 다른 내용을 만들 수 있습니다.showDelay
, hideDelay
, gap
, position
속성으로 툴팁이 나타나는 시점과 위치를 세밀하게 조정합니다.itemFormatter
는 역할이 다르므로, 목적에 맞는 API를 골라 쓰는 기준을 알아봅니다.JavaScript 차트 툴팁, Wijmo FlexChart는 어떻게 동작할까
Wijmo FlexChart는 사용자가 데이터 포인트에 마우스를 올리거나 터치하면 기본적으로 툴팁을 표시합니다. 별도 설정이 없을 때 템플릿은 <b>{seriesName}</b><br/>{x} {y}
이며, 시리즈 이름과 x·y 값만 보여줍니다.
툴팁 템플릿에서는 다음 파라미터를 사용할 수 있습니다.
파라미터는 반드시 중괄호 하나( {}
)로 감싸야 합니다. 툴팁은 FlexChart
가 가진 tooltip
속성( ChartTooltip
객체)을 통해 설정합니다.

JavaScript 차트 툴팁 직접 만들기: FlexChart 구현 방법 (Step-by-Step)
판매 대시보드에서 흔한 "월별 매출 vs 목표" 시나리오로 진행합니다. 한 번에 모두 만들지 않고, 같은 차트를 STEP마다 한 단계씩 개선합니다. 각 STEP의 코드는 이전 STEP을 포함한 누적 코드입니다.
STEP 1: CDN으로 Wijmo 라이브러리 불러오기
차트 예제에 필요한 Wijmo 스크립트와 스타일시트를 불러옵니다. FlexChart는 코어 모듈과 wijmo.chart
모듈이 필요하고, 한국어 문화권 파일을 추가하면 숫자·날짜 서식이 한국식으로 표시됩니다.
STEP 2: 차트를 그릴 HTML 컨테이너 만들기
차트가 그려질 div
를 하나 만듭니다.
STEP 3: 데이터를 정의하고 기본 툴팁이 있는 차트 만들기
월별 매출, 목표, 주문 건수를 담은 데이터를 만들고 두 시리즈를 가진 컬럼 차트를 생성합니다. 아직 tooltip
을 건드리지 않았으므로 기본 툴팁이 표시됩니다.
기본 툴팁은 "매출 1월 42000000"처럼 출력되어 단위도 구분 기호도 없습니다. 다음 STEP에서 이를 개선합니다.
STEP 4: 템플릿 문자열로 툴팁 서식 지정하기
tooltip.content
에 HTML 템플릿을 지정합니다. {y:n0}
처럼 파라미터 뒤에 콜론과 서식 코드를 붙이면 숫자에 천 단위 구분 기호가 적용됩니다.
이제 툴팁에는 "매출 / 1월: 42,000,000원"처럼 읽기 쉬운 형태로 표시됩니다. 템플릿에는 표나 이미지를 포함한 HTML도 쓸 수 있고, content
를 빈 문자열( ''
)로 지정하면 툴팁이 꺼집니다.
위 라이브 데모에서 서식이 적용된 템플릿이 여러 시리즈에 똑같이 적용되는 것을 확인할 수 있습니다. 시리즈마다 또는 포인트마다 다른 내용이 필요하면 다음 STEP의 함수 방식을 사용합니다.

STEP 5: 함수로 데이터 포인트마다 다른 툴팁 내용 만들기
content
에는 문자열 대신 함수도 지정할 수 있습니다. 함수는 HitTestInfo
객체를 인자로 받으며, ht.item
(원본 데이터 객체), ht.series
(시리즈), ht.pointIndex
, ht.x
, ht.y
등을 사용해 포인트마다 다른 HTML을 반환합니다. 여기서는 매출 시리즈에는 목표 달성률과 주문 건수를, 목표 시리즈에는 목표 금액만 표시합니다.
데이터 객체의 필드를 그대로 쓸 수 있으므로, 차트에 바인딩하지 않은 orders
같은 필드도 툴팁에서 보여줄 수 있습니다. 이것이 템플릿 문자열 방식과 함수 방식의 가장 큰 차이입니다.
STEP 6: 완성 — 툴팁 표시 지연과 위치 조정하기
마지막으로 툴팁이 나타나는 타이밍과 위치를 조정합니다. showDelay
는 마우스가 포인트에 들어온 뒤 툴팁이 나타나기까지의 지연(기본 500ms), gap
은 툴팁과 대상 사이 거리(기본 6px), position
은 대상 기준 표시 위치(기본 PopupPosition.Above
)입니다. isAnimated
를 켜면 페이드인 효과가 적용됩니다.
위 라이브 데모에서 각 막대에 마우스를 올려 보세요. 매출 막대에서는 목표 달성률이 초록색(달성) 또는 빨간색(미달)으로 표시되고, 목표 막대에서는 목표 금액만 간결하게 표시됩니다. 툴팁이 막대 가까이에서 바로 나타나는 것도 showDelay = 100
덕분입니다.
툴팁 스타일링과 itemFormatter, 무엇이 다를까
툴팁의 배경, 테두리, 여백은 .wj-tooltip
CSS 클래스로 바꿀 수 있습니다. 특정 차트의 툴팁만 다르게 꾸미려면 chart.tooltip.cssClass
에 별도 클래스명을 지정한 뒤 해당 클래스에 스타일을 정의합니다.
한 가지 주의할 점은 itemFormatter
와의 혼동입니다. itemFormatter
는 FlexChart가 막대, 점 같은 차트 요소를 그릴 때 호출되어 요소의 모양(색, 스타일 등)을 바꾸는 속성이며, 툴팁 내용을 만드는 API가 아닙니다. 툴팁 텍스트를 바꾸려면 tooltip.content
를, 포인트별로 막대 색이나 모양을 다르게 하려면 itemFormatter
를 사용하세요. 두 기능을 함께 쓰면 "달성한 달은 초록 막대 + 달성률 툴팁" 같은 대시보드 상호작용을 만들 수 있습니다.
자주 묻는 질문 (FAQ)
Wijmo FlexChart 툴팁이란 무엇인가요?
chart.tooltip
속성으로 내용과 동작을 모두 바꿀 수 있습니다.JavaScript 차트 툴팁 내용을 원하는 형식으로 바꾸려면 어떻게 하나요?
chart.tooltip.content
에 '<b>{seriesName}</b><br/>{x}: {y:n0}원'
처럼 파라미터가 들어간 HTML 템플릿 문자열을 지정합니다. 사용할 수 있는 파라미터는 seriesName
, pointIndex
, x
, y
, value
, name
과 데이터 객체의 속성명입니다.차트에서 데이터 포인트별로 다른 툴팁을 보여주려면 어떻게 하나요?
content
에 함수를 지정합니다. 함수는 HitTestInfo
를 인자로 받으므로 ht.item
으로 원본 데이터를, ht.series.name
으로 시리즈를 확인해 조건에 따라 서로 다른 HTML 문자열을 반환하면 됩니다.차트 툴팁에 천 단위 구분이나 통화 서식을 적용하는 방법은?
{sales:n0}
(천 단위 구분), {sales:c2}
(통화, 소수 둘째 자리)처럼 필드명 뒤에 서식 코드를 붙입니다. 함수 방식에서는 wijmo.Globalize.format(value, 'n0')
을 사용합니다. 한국어 문화권 파일( wijmo.culture.ko.min.js
)을 로드하면 한국식 표기가 적용됩니다.
