이벤트
chart.on(event, listener)는 듣기를 멈추는 함수를 돌려줍니다:
| 이벤트 | 내용 | 언제 |
|---|---|---|
ready |
{ chart, instance, symbol, timeframe } |
첫 차트가 만들어져 데이터를 불러오기 시작할 때. 내용은 chartReady와 같으며, 현재 차트입니다 |
chartReady |
{ chart, instance, symbol, timeframe } |
레이아웃의 차트 하나가 만들어질 때(다시 만들 때 포함). chart는 레이아웃에서의 위치, instance는 그 Chart입니다. 여기서 차트마다 페이지 자체의 표시나 선을 더합니다 |
symbolChange |
{ chart, symbol } |
현재 차트가 표시하는 종목이 바뀔 때: 사용자가 골랐거나, 메서드로 바꿨거나, 다른 차트가 현재 차트가 되었을 때. chart는 현재 차트의 레이아웃에서의 위치입니다 |
watchlistStar |
{ symbol, starred } |
사용자가 종목 검색에서 별표를 눌렀을 때: starred가 true면 관심 종목에 넣으려는 것, false면 빼려는 것입니다. 페이지는 자기 목록을 바꾼 뒤 다시 watchlist에 줍니다. "관심 종목" 참고 |
timeframeChange |
{ chart, timeframe } |
위와 같음, 주기 |
chartTypeChange |
{ chart, chartType, settings } |
위와 같음, 차트 유형. 현재 유형의 설정(예: 틱 바의 체결 건수)을 바꿨을 때도 내보냅니다. settings는 현재 유형의 설정이며, 설정이 없는 유형은 null |
indicatorsChange |
{ chart, indicators } |
어떤 차트의 지표가 추가·삭제되었거나, 파라미터나 선이 바뀌었거나, 표시·숨김이 바뀌었을 때. chart는 레이아웃에서의 위치입니다 |
comparisonsChange |
{ chart, comparisons } |
어떤 차트의 비교 종목이 추가·삭제되었거나, 위치나 스타일이 바뀌었거나, 표시·숨김이 바뀌었을 때 |
drawingsChange |
{ chart, symbol, drawings } |
어떤 차트의 어떤 종목의 그리기가 바뀌었을 때(그리기는 차트에 속함) |
alertsChange |
{ symbol, alerts } |
어떤 종목의 알림이 추가·변경·이동·일시정지·재개·삭제되었을 때 |
alertStatusChange |
{ symbol, id, status } |
페이지가 알림을 감시하는지가 바뀌었을 때: 감시 시작, 데이터가 아직 오는 중, 일시정지, 만료, 감시할 수 없음. "알림" 참고 |
alert |
아래 참고 | 알림이 울렸을 때 |
layoutChange |
{ grid, active, links } |
멀티 차트 레이아웃, 현재 차트, 연동 방식이 바뀌었을 때 |
crosshairMove |
{ chart, symbol, time, price, paneId } |
포인터가 차트 위에서 움직일 때. 벗어나면 time, price, paneId가 null |
visibleRangeChange |
{ chart, symbol, range } |
차트에 표시되는 봉이 바뀌었을 때(드래그, 확대·축소, 불러오기). range는 { from, to }로, 첫 봉과 마지막 봉의 시간 |
chartClick |
{ chart, symbol, time, price, paneId } |
차트의 그리기 영역을 눌렀을 때 |
buttonClick |
{ id, item } |
페이지 자체의 버튼을 눌렀을 때. 메뉴가 있으면 item이 고른 메뉴 항목 |
drawingBarClick |
{ id, chart, symbol, drawing } |
플로팅 바의 페이지 자체 버튼(drawingBarItems)을 눌렀을 때. drawing은 선택된 그리기(id 포함) |
drawingToolChange |
{ active, magnet, continuous, hidden, favorites } |
그리기 도구의 상태가 바뀌었을 때: 도구를 집어 들거나 내려놓음, 자석, 연속 그리기, 그리기 숨기기, 즐겨찾는 도구 |
drawingSelectionChange |
{ selected } |
현재 차트에서 선택된 그리기가 바뀌었거나 풀렸거나, 선택된 그리기가 변했을 때. 내용은 "직접 만드는 그리기 도구 모음" 참고 |
drawingBoundsChange |
{ chart, id, bounds } |
선택된 그리기가 창 안에서 위치를 옮겼을 때. 들을 때만 잽니다 |
contextMenuClick |
{ id, chart, symbol, time, price, order? } |
페이지 자체의 우클릭 메뉴 항목을 골랐을 때 |
contextMenuClose |
{ chart, symbol, time, price, order? } |
페이지 항목이 있는 우클릭 메뉴가 닫혔거나 다른 메뉴로 바뀌었을 때. 인수는 열 때 contextMenu에 준 것과 같으며, 예를 들어 메뉴가 열려 있는 동안 그린 것을 치우는 데 씁니다 |
dataError |
{ chart, symbol, request, interval, error } |
데이터 피드에서 오류가 났을 때: request는 symbol(resolveSymbol), bars(getBars), history(왼쪽으로 이전 봉 불러오기) 중 하나. error는 데이터 피드가 던진 오류로, 자체 모니터링에 보고할 수 있습니다 |
storageError |
{ operation, error } |
저장소에서 오류가 났을 때: operation은 load(읽지 못함. 이번에 열려 있는 동안 저장하지 않음) 또는 save(저장하지 못함. 다음 변화 때 다시 저장). 기본 브라우저 저장소는 공간이 가득 찼거나 사용할 수 없을 때도 알립니다 |
alert의 내용: id(어느 알림인지), symbol, timeframe(어느 주기의 봉으로 판단했는지), time(울릴 때 그 봉의 시간), price(그 봉의 종가), subject(무엇을 비교했는지. 그리기는 유형으로 쓰므로 그리기가 삭제되어도 알아볼 수 있음: { source, trigger, value }), message(사용자가 쓴 메시지), replay(과거를 리플레이하는 중에 울렸는지), remote(다른 곳에서 판단해 reportAlert()로 알려 온 것인지. "알림" 참고), title과 body(차트의 언어로 쓴 알림 문구. 예: "알림" "BTC/USDT 상향 교차 68,000.00 · 돌파 확인"이며, 그대로 푸시에 쓸 수 있음).
time은 모두 밀리초 타임스탬프이고, price는 메인 창에서는 가격, 보조 창에서는 지표의 값입니다. 모든 이벤트 이름은 PRO_CHART_EVENTS에 있습니다. symbolChange부터 alertsChange까지 상태를 알리는 이벤트는 한 차례의 변화가 끝난 뒤에 내보내며, 결과만 알립니다. 예를 들어 setState()가 종목, 레이아웃, 지표를 바꿔도 각각 한 번만 알립니다.
// 페이지 자체의 시세 바가 십자선을 따라갑니다.
chart.on('crosshairMove', ({ time, price }) => {
quoteBar.show(time === null ? null : { time, price });
});
// 데이터 피드 오류를 보고합니다.
chart.on('dataError', ({ symbol, request, error }) => {
monitor.capture(error, { symbol, request });
});