API
API
Classes
RcChartSeries

RcChartSeries

Extends

์ฐจํŠธ ์‹œ๋ฆฌ์ฆˆ ๋ชจ๋ธ๋“ค์˜ ๊ธฐ๋ฐ˜ ํด๋ž˜์Šค.

Properties

name: string (opens in a new tab)

config์—์„œ ์„ค์ •ํ•ด๋œ name์„ ๋ฆฌํ„ดํ•œ๋‹ค.
์ตœ์ดˆ ์„ค์ •ํ•œ ์ด๋ฆ„์€ ๋ณ€๊ฒฝํ•  ์ˆ˜ ์—†๋‹ค.

pointCount: number (opens in a new tab)

์‹œ๋ฆฌ์ฆˆ์— ์„ค์ •๋œ ๋ฐ์ดํ„ฐํฌ์ธํŠธ ๊ฐœ์ˆ˜.

pointLabel: RcChartObject

point label ๋ชจ๋ธ.

tooltip: RcChartObject

point label ๋ชจ๋ธ.

trendLine: RcChartObject

point label ๋ชจ๋ธ.

visiblePointCount: number (opens in a new tab)

์‹œ๋ฆฌ์ฆˆ์— ์„ค์ •๋œ ๋ฐ์ดํ„ฐํฌ์ธํŠธ๋“ค ์ค‘ ํ‘œ์‹œ ์ค‘์ธ ๊ฒƒ๋“ค์˜ ๊ฐœ์ˆ˜.

Methods

addPoint(source): IRcDataPoint

๋ฐ์ดํ„ฐํฌ์ธํŠธ๋ฅผ ์ถ”๊ฐ€ํ•œ๋‹ค.

ParameterTypeDescription
sourceany (opens in a new tab)๋ฐ์ดํ„ฐํฌ์ธํŠธ ์›๋ณธ ์ •๋ณด.

addPoints(source): Array (opens in a new tab) | < | IRcDataPoint | >

ํ•˜๋‚˜ ์ด์ƒ์˜ ๋ฐ์ดํ„ฐํฌ์ธํŠธ๋“ค์„ ์ถ”๊ฐ€ํ•œ๋‹ค.

ParameterTypeDescription
sourceArray (opens in a new tab) | < | any (opens in a new tab) | >๋ฐ์ดํ„ฐํฌ์ธํŠธ ์›๋ณธ ๋ชฉ๋ก.

get(prop): any (opens in a new tab)

์ง€์ •ํ•œ ์„ค์ • ๊ฐ’(๋“ค)์„ ๊ฐ€์ ธ์˜จ๋‹ค.
์ง€์ • ๊ฐ€๋Šฅํ•œ ์„ค์ • ๊ฐ’ ๋ชฉ๋ก์€ Configuration API ํŽ˜์ด์ง€์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

Utils.log(chart.series.get('name'))

ํ•˜์œ„ ๊ฐ์ฒด์˜ ์„ค์ • ์†์„ฑ์€ ์†์„ฑ ๊ฒฝ๋กœ๋ฅผ ์ง€์ •ํ•ด์„œ ์ง์ ‘ ๊ฐ€์ ธ์˜ฌ ์ˆ˜๋„ ์žˆ๋‹ค.

Utils.log(chart.axis.get('title.text'));

์†์„ฑ ๋ณ€๊ฒฝ์€ set, setAll, toggle๋“ฑ์œผ๋กœ ์‹คํ–‰ํ•œ๋‹ค.

ParameterTypeDescription
propstring (opens in a new tab)'.'์œผ๋กœ ๊ตฌ๋ถ„๋˜๋Š” ์†์„ฑ ๊ฒฝ๋กœ.

getPointAt(xValue): IRcDataPoint

์ง€์ •ํ•œ x์ถ• ๊ฐ’์— ์œ„์น˜ํ•œ ์ฒซ๋ฒˆ์งธ ๋ฐ์ดํ„ฐํฌ์ธํŠธ์˜ ์ •๋ณด๋ฅผ ๋ฆฌํ„ดํ•œ๋‹ค.
์ „๋‹ฌ๋˜๋Š” ๋ฐ์ดํ„ฐํฌ์ธํŠธ ์ •๋ณด๋Š” ๋ฆฌํ„ด ์‹œ์ ์˜ ๋ณต์‚ฌ๋ณธ์ด๋‹ค.

ParameterTypeDescription
xValuestring (opens in a new tab) | number (opens in a new tab)x๊ฐ’.

getValueAt(xValue, prop): number (opens in a new tab)

xValue์— ํ•ด๋‹นํ•˜๋Š” ์ฒซ๋ฒˆ์งธ ๋ฐ์ดํ„ฐํฌ์ธํ„ฐ์˜ yValue๋ฅผ ๋ฆฌํ„ดํ•œ๋‹ค.

ParameterTypeDescription
xValuestring (opens in a new tab) | number (opens in a new tab) | IRcDataPointx๊ฐ’ ํ˜น์€ x,y๊ฐ’์ด ํฌํ•จ๋œ ๋ฐ์ดํ„ฐํฌ์ธํŠธ ์ •๋ณด. x์ถ•์ด category ์ถ•์ด๋ฉด ์นดํ…Œ๊ณ ๋ฆฌ ์ด๋ฆ„์„ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๋‹ค.
prop='yValue'string (opens in a new tab)๊ฐ€์ ธ์˜ฌ ๊ฐ’. ์ง€์ •ํ•˜์ง€ ์•Š์œผ๋ฉด 'yValue'.

removePoint(xValue): boolean (opens in a new tab)

๋ฐ์ดํ„ฐํฌ์ธํŠธ๋ฅผ ์ œ๊ฑฐํ•œ๋‹ค.

ParameterTypeDescription
xValuestring (opens in a new tab) | number (opens in a new tab) | IRcDataPoint์ œ๊ฑฐํ•  ๋ฐ์ดํ„ฐํฌ์ธํŠธ์˜ x๊ฐ’ ํ˜น์€ ์นดํ…Œ๊ณ ๋ฆฌ ์ด๋ฆ„. ๋˜๋Š” getPointAt์ด๋‚˜ findPoint๋กœ ๊ฐ€์ ธ์˜จ ๋ฐ์ดํ„ฐํฌ์ธํŠธ ์ •๋ณด ๊ฐ์ฒด.

removePoints(xValues): number (opens in a new tab)

ํ•˜๋‚˜ ์ด์ƒ์˜ ๋ฐ์ดํ„ฐํฌ์ธํŠธ๋“ค์„ ์ œ๊ฑฐํ•œ๋‹ค.

ParameterType
xValuesArray (opens in a new tab) | < | string (opens in a new tab) | number (opens in a new tab) | IRcDataPoint | >

set(prop, value, redraw): RcChartObject

์ง€์ •ํ•œ ์†์„ฑ์˜ ๊ฐ’(๋“ค)์„ ์„ค์ •ํ•œ๋‹ค.
์ง€์ • ๊ฐ€๋Šฅํ•œ ์„ค์ • ๊ฐ’ ๋ชฉ๋ก์€ Configuration API ํŽ˜์ด์ง€์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.
๋˜, ์ด ๊ฐ์ฒด ์ž์‹ ์„ ๋ฆฌํ„ดํ•˜๋ฏ€๋กœ javascript์—์„œ builder ํŒจํ„ด์œผ๋กœ ์„ค์ • ๊ฐ’๋“ค์„ ์—ฐ์†ํ•ด์„œ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๋‹ค.

 chart.series.set('xAxis', 1).set('yAxis', 1);

get์—์„œ์™€ ๋งˆ์ฐฌ๊ฐ€์ง€๋กœ ํ•˜์œ„ ๊ฐ์ฒด์˜ ์„ค์ • ์†์„ฑ์„ ์†์„ฑ ๊ฒฝ๋กœ๋ฅผ ํ†ตํ•ด ์ง์ ‘ ์„ค์ •ํ•  ์ˆ˜๋„ ์žˆ๋‹ค.

chart.axis.set('title.text', 'New Title'));
ParameterTypeDescription
propstring (opens in a new tab)์„ค์ • ์†์„ฑ ๊ฒฝ๋กœ ๋ฌธ์ž์—ด
valueany (opens in a new tab)์ง€์ •ํ•  ๊ฐ’(๋“ค)
redraw=trueboolean (opens in a new tab)true๋กœ ์ง€์ •ํ•˜๋ฉด chart๋ฅผ ๋‹ค์‹œ ๊ทธ๋ฆฐ๋‹ค. false๋กœ ์ง€์ •ํ•˜๊ณ  ์—ฌ๋Ÿฌ ์„ค์ • ํ›„์— render๋ฅผ ํ˜ธ์ถœํ•ด์„œ ๋‹ค์‹œ ๊ทธ๋ฆฌ๊ฒŒ ํ•  ์ˆ˜๋„ ์žˆ๋‹ค.

setAll(props, redraw): RcChartObject

JSON ๊ฐ์ฒด๋กœ ์ง€์ •ํ•œ ์†์„ฑ๋“ค์˜ ๊ฐ’์„ ์„ค์ •ํ•œ๋‹ค.
์ง€์ • ๊ฐ€๋Šฅํ•œ ์„ค์ • ๊ฐ’ ๋ชฉ๋ก์€ Configuration API ํŽ˜์ด์ง€์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

 chart.series.set({
     xAxis: 1,
     yAxis: 1,
     yField: 'salary'
 });
ParameterTypeDescription
propsobject (opens in a new tab)์—ฌ๋Ÿฌ ์„ค์ • ๊ฐ’๋“ค์ด ์ง€์ •๋œ JSON ๊ฐ์ฒด
redraw=trueboolean (opens in a new tab)true๋กœ ์ง€์ •ํ•˜๋ฉด chart๋ฅผ ๋‹ค์‹œ ๊ทธ๋ฆฐ๋‹ค. false๋กœ ์ง€์ •ํ•˜๊ณ  ์—ฌ๋Ÿฌ ์„ค์ • ํ›„์— render๋ฅผ ํ˜ธ์ถœํ•ด์„œ ๋‹ค์‹œ ๊ทธ๋ฆฌ๊ฒŒ ํ•  ์ˆ˜๋„ ์žˆ๋‹ค.

toggle(prop, redraw): RcChartObject

Boolean ํƒ€์ž…์˜ ์„ค์ •๊ฐ’์„ ๋ณ€๊ฒฝํ•œ๋‹ค.
์ง€์ • ๊ฐ€๋Šฅํ•œ ์„ค์ • ๊ฐ’ ๋ชฉ๋ก์€ Configuration API ํŽ˜์ด์ง€์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค.

chart.getSeries('ser02').toggle('visible');
ParameterTypeDescription
propstring (opens in a new tab)์„ค์ • ์†์„ฑ ์ด๋ฆ„
redraw=trueboolean (opens in a new tab)true๋กœ ์ง€์ •ํ•˜๋ฉด chart๋ฅผ ๋‹ค์‹œ ๊ทธ๋ฆฐ๋‹ค. false๋กœ ์ง€์ •ํ•˜๊ณ  ์—ฌ๋Ÿฌ ์„ค์ • ํ›„์— render๋ฅผ ํ˜ธ์ถœํ•ด์„œ ๋‹ค์‹œ ๊ทธ๋ฆฌ๊ฒŒ ํ•  ์ˆ˜๋„ ์žˆ๋‹ค.

updateData(data): void (opens in a new tab)

์‹œ๋ฆฌ์ฆˆ data ์›๋ณธ์„ ๋ณ€๊ฒฝํ•œ๋‹ค.
[์ฃผ์˜] x์ถ•์ด ์นดํ…Œ๊ณ ๋ฆฌ ์ถ•์ด๊ณ , x์ถ•์˜ categories ์†์„ฑ์ด ๋ช…์‹œ์ ์œผ๋กœ ์„ค์ •๋˜์ง€ ์•Š์•˜๋‹ค๋ฉด, ์ด ํ•จ์ˆ˜ ํ˜ธ์ถœ ํ›„ ์นดํ…Œ๊ณ ๋ฆฌ๊ฐ€ ๋ณ€๊ฒฝ๋  ์ˆ˜ ์žˆ๋‹ค.

ParameterTypeDescription
dataany (opens in a new tab)์›๋ณธ ๋ฐ์ดํ„ฐํฌ์ธํŠธ ๊ฐ’ ๋ฐฐ์—ด.

updatePoint(xValue, values): boolean (opens in a new tab)

xValue์— ํ•ด๋‹นํ•˜๋Š” ์ฒซ๋ฒˆ์งธ ๋ฐ์ดํ„ฐํฌ์ธํ„ฐ์˜ ๊ฐ’๋“ค์„ ๋ณ€๊ฒฝํ•œ๋‹ค.
์‹œ๋ฆฌ์ฆˆ์— data๋ฅผ ์ง€์ •ํ•˜๋Š” ๊ฒƒ๊ณผ ๋™์ผํ•œ ๋ฐฉ์‹์œผ๋กœ ๋ฐ์ดํ„ฐํฌ์ธํŠธ์˜ ๊ฐ’(๋“ค)์„ ๋ณ€๊ฒฝํ•  ์ˆ˜ ์žˆ๋‹ค.
[์ฃผ์˜] json์œผ๋กœ ํ•„๋“œ๊ฐ’(๋“ค)์„ ์ง€์ •ํ•  ๋•Œ๋Š” ์‹œ๋ฆฌ์ฆˆ์— ์ง€์ •๋œ field ์ด๋ฆ„ ์†์„ฑ๋“ค๊ณผ ๊ฐ™์€ ์ด๋ฆ„์œผ๋กœ ๊ฐ’๋“ค์„ ์ง€์ •ํ•ด์•ผ ํ•œ๋‹ค.

const x = '์นดํ…Œ๊ณ ๋ฆฌ';
const v = chart.series.getValueAt(x);

chart.series.updatePoint(x, v + 10);
ParameterTypeDescription
xValuestring (opens in a new tab) | number (opens in a new tab) | IRcDataPointx๊ฐ’. x์ถ•์ด category ์ถ•์ด๋ฉด ์นดํ…Œ๊ณ ๋ฆฌ ์ด๋ฆ„์„ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๋‹ค.
valuesany (opens in a new tab)๋ณ€๊ฒฝํ•  ๋‹จ์ผ ๊ฐ’, ๋ฐฐ์—ด, ๋˜๋Š” json.