addPlotBand (ChartObject method)

축에 구간 강조 영역(plotBand)을 추가합니다.
추가한 영역은 속성에도 반영되어 draw()로 다시 그려도 유지됩니다. 차트가 그려지기 전(draw() 호출 전)에 호출하면 -1을 반환합니다.

Syntax

{ibchart}.addPlotBand(axisType, band, [index]);

Parameters

Name Type Required Description
axisType string 필수 축 종류 (xAxis, yAxis)
band object 필수 영역 속성. xAxis plotBands와 같은 형식 (from, to, color, label 등)
band.id string 선택 영역 id. 생략하면 자동으로 만들어 반환합니다.
영역을 구분할 임의의 문자열 (예: "holiday"). 생략하면 "ib-plotBands-1" 형식으로 자동 생성됩니다.
index number 선택(0) 축 인덱스

Returns

string 추가된 영역의 id, 실패 시 -1

Example

// x축 1~2 구간을 강조
var bandId = myChart.addPlotBand("xAxis", {
  from: 1,
  to: 2,
  color: "#FFEFD5",
  label: { text: "점검 기간" }
});

// 제거
myChart.removePlotBand("xAxis", bandId);

참고

Since

version desc
7.3.1.32