Wijmo 블로그 MESCIUS 기술 블로그 ·

Wijmo FlexChart 툴팁 커스터마이징: 템플릿·함수로 구현하기

차트에 마우스를 올렸을 때 "1월 42000000" 같은 가공되지 않은 숫자만 보인다면, 사용자는 그 값이 얼마인지, 목표 대비 어느 수준인지 바로 알기 어렵습니다. 처음 JavaScript 차트 툴팁을 만들어 보는 개발자라면 어디서부터 손대야 할지 막막할 수 있습니다. Wijmo(위즈모) by MESCIUS(메시어스)의 FlexChart는 tooltip 속성 하나로 툴팁의 내용, 서식, 표시 시점, 위치를 모두 코드로 제어할 수 있습니다.

이 글에서는 기본 툴팁에서 출발해 템플릿 문자열, 함수, 표시 옵션까지 단계별로 다듬으며 월별 매출 차트를 완성합니다.

⭐
Key Points
이 글에서 다루는 핵심 내용
01
chart.tooltip.content 에 {seriesName} , {x} , {y} 같은 파라미터가 담긴 HTML 템플릿 문자열을 넣으면 툴팁 형식이 바뀝니다.
02
{sales:n0} 처럼 데이터 필드명 뒤에 서식 코드를 붙여 천 단위 구분과 통화 서식을 적용할 수 있습니다.
03
content 에 함수를 지정하면 HitTestInfo 객체( ht.item , ht.series , ht.pointIndex )를 받아 데이터 포인트마다 다른 내용을 만들 수 있습니다.
04
showDelay , hideDelay , gap , position 속성으로 툴팁이 나타나는 시점과 위치를 세밀하게 조정합니다.
05
툴팁과 itemFormatter 는 역할이 다르므로, 목적에 맞는 API를 골라 쓰는 기준을 알아봅니다.

JavaScript 차트 툴팁, Wijmo FlexChart는 어떻게 동작할까

Wijmo FlexChart는 사용자가 데이터 포인트에 마우스를 올리거나 터치하면 기본적으로 툴팁을 표시합니다. 별도 설정이 없을 때 템플릿은 <b>{seriesName}</b><br/>{x} {y} 이며, 시리즈 이름과 x·y 값만 보여줍니다.

툴팁 템플릿에서는 다음 파라미터를 사용할 수 있습니다.

파라미터 의미
{seriesName} 데이터 포인트가 속한 시리즈 이름
{pointIndex} 시리즈 내 데이터 포인트 인덱스
{x} / {y} 데이터 포인트의 x값 / y값
{value} 데이터 포인트의 값 (FlexChart에서는 y값)
{name} 데이터 포인트 이름 (FlexChart에서는 x값)
{propertyName} 해당 데이터 객체의 임의 속성 (예: {sales} )

파라미터는 반드시 중괄호 하나( {} )로 감싸야 합니다. 툴팁은 FlexChart 가 가진 tooltip 속성( ChartTooltip 객체)을 통해 설정합니다.

차트 막대 위에 마우스를 올리면 말풍선이 나타나는 개념 일러스트

💡 SUMMARY
Wijmo FlexChart는 MESCIUS가 제공하는 JavaScript 차트로, 툴팁 내용과 서식을 코드로 자유롭게 바꿀 수 있습니다.

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의 함수 방식을 사용합니다.

데이터 포인트가 포맷터를 거쳐 말풍선으로 전달되는 흐름 다이어그램

💡 SUMMARY
Wijmo FlexChart의 tooltip 속성에 내용 템플릿이나 함수를 지정하면 데이터 포인트별 맞춤 툴팁을 표시합니다.

STEP 5: 함수로 데이터 포인트마다 다른 툴팁 내용 만들기

content 에는 문자열 대신 함수도 지정할 수 있습니다. 함수는 HitTestInfo 객체를 인자로 받으며, ht.item (원본 데이터 객체), ht.series (시리즈), ht.pointIndex , ht.x , ht.y 등을 사용해 포인트마다 다른 HTML을 반환합니다. 여기서는 매출 시리즈에는 목표 달성률과 주문 건수를, 목표 시리즈에는 목표 금액만 표시합니다.

데이터 객체의 필드를 그대로 쓸 수 있으므로, 차트에 바인딩하지 않은 orders 같은 필드도 툴팁에서 보여줄 수 있습니다. 이것이 템플릿 문자열 방식과 함수 방식의 가장 큰 차이입니다.

💡 SUMMARY
content에 함수를 지정하면 HitTestInfo의 item·series·pointIndex를 활용해 데이터 포인트마다 다른 툴팁 내용을 만들 수 있습니다.

STEP 6: 완성 — 툴팁 표시 지연과 위치 조정하기

마지막으로 툴팁이 나타나는 타이밍과 위치를 조정합니다. showDelay 는 마우스가 포인트에 들어온 뒤 툴팁이 나타나기까지의 지연(기본 500ms), gap 은 툴팁과 대상 사이 거리(기본 6px), position 은 대상 기준 표시 위치(기본 PopupPosition.Above )입니다. isAnimated 를 켜면 페이드인 효과가 적용됩니다.

실행 결과

위 라이브 데모에서 각 막대에 마우스를 올려 보세요. 매출 막대에서는 목표 달성률이 초록색(달성) 또는 빨간색(미달)으로 표시되고, 목표 막대에서는 목표 금액만 간결하게 표시됩니다. 툴팁이 막대 가까이에서 바로 나타나는 것도 showDelay = 100 덕분입니다.

💡 SUMMARY
showDelay, gap, position, isAnimated 속성으로 FlexChart 툴팁의 표시 시점과 위치, 애니메이션을 코드로 조정할 수 있습니다.

툴팁 스타일링과 itemFormatter, 무엇이 다를까

툴팁의 배경, 테두리, 여백은 .wj-tooltip CSS 클래스로 바꿀 수 있습니다. 특정 차트의 툴팁만 다르게 꾸미려면 chart.tooltip.cssClass 에 별도 클래스명을 지정한 뒤 해당 클래스에 스타일을 정의합니다.

한 가지 주의할 점은 itemFormatter 와의 혼동입니다. itemFormatter 는 FlexChart가 막대, 점 같은 차트 요소를 그릴 때 호출되어 요소의 모양(색, 스타일 등)을 바꾸는 속성이며, 툴팁 내용을 만드는 API가 아닙니다. 툴팁 텍스트를 바꾸려면 tooltip.content 를, 포인트별로 막대 색이나 모양을 다르게 하려면 itemFormatter 를 사용하세요. 두 기능을 함께 쓰면 "달성한 달은 초록 막대 + 달성률 툴팁" 같은 대시보드 상호작용을 만들 수 있습니다.

💡 SUMMARY
툴팁 내용은 tooltip.content로, 차트 요소의 모양은 itemFormatter로 각각 제어하며 스타일은 .wj-tooltip 클래스로 조정합니다.

자주 묻는 질문 (FAQ)

Q01

Wijmo FlexChart 툴팁이란 무엇인가요?

FlexChart 툴팁은 데이터 포인트에 마우스를 올리거나 터치할 때 나타나는 정보 팝업입니다. 기본 템플릿은 시리즈 이름과 x·y 값을 보여주며, chart.tooltip 속성으로 내용과 동작을 모두 바꿀 수 있습니다.
Q02

JavaScript 차트 툴팁 내용을 원하는 형식으로 바꾸려면 어떻게 하나요?

chart.tooltip.content 에 '<b>{seriesName}</b><br/>{x}: {y:n0}원' 처럼 파라미터가 들어간 HTML 템플릿 문자열을 지정합니다. 사용할 수 있는 파라미터는 seriesName , pointIndex , x , y , value , name 과 데이터 객체의 속성명입니다.
Q03

차트에서 데이터 포인트별로 다른 툴팁을 보여주려면 어떻게 하나요?

content 에 함수를 지정합니다. 함수는 HitTestInfo 를 인자로 받으므로 ht.item 으로 원본 데이터를, ht.series.name 으로 시리즈를 확인해 조건에 따라 서로 다른 HTML 문자열을 반환하면 됩니다.
Q04

차트 툴팁에 천 단위 구분이나 통화 서식을 적용하는 방법은?

템플릿 문자열에서는 {sales:n0} (천 단위 구분), {sales:c2} (통화, 소수 둘째 자리)처럼 필드명 뒤에 서식 코드를 붙입니다. 함수 방식에서는 wijmo.Globalize.format(value, 'n0') 을 사용합니다. 한국어 문화권 파일( wijmo.culture.ko.min.js )을 로드하면 한국식 표기가 적용됩니다.
Q05

툴팁 커스터마이징이 쉬운 JavaScript 차트 라이브러리는?

Wijmo FlexChart는 템플릿 문자열 한 줄로 시작해 필요하면 함수로 확장하는 점진적인 방식을 제공하며, HTML 표나 이미지도 툴팁에 넣을 수 있어 대시보드 상호작용을 빠르게 다듬을 수 있습니다.
Q06

상용 JavaScript 차트 라이브러리 중 한국어 기술지원을 받을 수 있는 곳은?

Wijmo를 제공하는 MESCIUS(메시어스)는 한국어 공식 사이트(https://www.mescius.co.kr/wijmo)와 한국어 데모·API 문서(https://demo.mescius.co.kr/wijmo/demos/)를 운영합니다. 기술지원 범위와 방법은 공식 사이트에서 확인하세요.

MESCIUS Wijmo

지금 바로 Wijmo 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

Wijmo 무료 체험판 다운로드