1.6 ETC API

3 ETC

getData()

차트를 이루고 있는 데이터를 호출한다.

parameters -

returns

_data

array

파싱된 차트용 JSON DATA가 들어간 배열

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.getData();
 
// OUTPUT
{
	main: {
		DATA-s1: {
			base: 0,
			data: [
				// 실제 사용된 데이터
				{ ... },
				{ ... }
			],
			max: 0,
			maxvalue: 0,
			min: 0,
			minvalue: 0,
			yAxis: [...]
		}
	}
}

getOriginalData()

차트용 데이터로 파싱하기 이전의 데이터 원본 호출

parameters -

returns

_data

array

파싱되지 않은 JSON 원본 데이터 배열

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.getOriginalData();
 
// OUTPUT
[
{원본 JSON 데이터},
{원본 JSON 데이터},
...
];

setOriginalData(_datas)

차트의 원본데이터를 새로운 데이터로 변경

차트의 원본 데이터만 변경하는 것이므로 실제 차트에서는 아무 동작하지 않는다.

다시 그려주는 API를 이용하여 차트를 다시 그려야 한다.

Parameters

_data

array

파싱되지 않은 JSON 원본 데이터 배열

returns -

var chart = webponent.chart.init($('.chart01'), options, styles, series);

var datas = [
{원본 JSON 데이터},
{원본 JSON 데이터},
...
];
chart.setOriginalData(datas);

appendData(...)

기존 차트 데이터에 신규 데이터를 추가

Parameters

_data

array(json)

추가되는 데이터(json으로 이루어진 배열)

returns -

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.appendData([{xaxis: '20130101', yaxis: '100000'}, {xaxis: '20130102', yaxis: '150000'}]);

getOptions()

차트를 이루고 있는 옵션을 가져온다.

parameters -

returns

options

Object

차트 옵션

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.getOptions();
 
// OUTPUT
{
	animate: { ... },
	data: {...},
	...
}

getStyles()

차트를 이루고 있는 스타일을 가져온다.

parameters -

returns

styles

Object

차트 스타일

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.getStyles();
 
// OUTPUT
{
	main: {
		...
	}
}

getSeries()

차트를 이루고 있는 시리즈를 가져온다.

parameters -

returns

series

Object

차트 시리즈

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.getSeries();
 
// OUTPUT
{
	main: {
		s1: {series: 'column', xaxis: 'xaxisKey', yaxis: 'yaxisKey'},
		//...
	}
}

setSeries(_series)

차트를 시리즈를 변경한다.

시리즈의 현황만 변경하는 것이므로 실제 차트에서는 아무 동작하지 않는다.

다시 그려주는 API를 이용하여 차트를 다시 그려야 한다.

parameters

_series

Object

변경할 새 차트 시리즈

returns -

var chart = webponent.chart.init($('.chart01'), options, styles, series);
var newSeries = {
	main: {
		s1: {series: 'column', xaxis: 'xaxisKey', yaxis: 'yaxisKey'}
	}
};
chart.setSeries(newSeries);

reDraw(...)

차트를 다시 그리고 싶을 때 호출한다.

Parameters

_data	array	JSON DATA가 들어간 배열(생략가능)
_styles	object	변경하고자 하는 스타일 (생략가능)
_series	object	변경하고자 하는 시리즈(생략가능)
_reYAxis	boolean	Y축 Value를 다시 구하고 싶을 때 true(생략가능)

returns -

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.reDraw();

// or
chart.reDraw([{...}, {...}], {}, {});

inquery(...)

reDraw()와 비슷하지만 데이터 호출부터 다시 시작한다.

검색조건에 의해 데이터(url 혹은 json)가 변경이 될 경우에 사용한다.

Parameters

_options	object	변경하고자 하는 옵션
_styles	object	변경하고자 하는 스타일
_series	object	변경하고자 하는 시리즈

returns -

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.inquery(options, styles, series);

resize()

차트의 리사이즈 이벤트를 직접 호출한다.

차트 wrapper의 DIV의 사이즈에 맞춰 차트가 다시 그려진다.

Parameters -

returns -

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.resize();

getXAxisLabels()

X축의 텍스트 Element 들 가져오기

Raphael Text Element 가 넘어오기 때문에 이 Element 에 Raphael 속성을 직접 컨트롤 할 수 있다.

단, 재조회나 리사이즈 등 다시 그려지는 API가 동작하면 이때 컨트롤한 속성을 다시 적용시켜 주어야 한다.

Parameters -

returns

nodes

array(Element)

차트에 그려진 X라벨 TEXT Element 전부를 가져온다.

var chart = webponent.chart.init($('.chart01'), options, styles, series);
 
chart.getXAxisLabels();
// OUTPUT
{
	main: [
		xLabelElement[0],
		xLabelElement[1],
		xLabelElement[2],
		...
	]
}

매물분석도

saleAnalysis(...)

매물분석도 전용 함수 - 생성

Parameters

_param

Number

매물분석도 Rectangle의 갯수 (기본 10)

_series

object

종합차트용 series object

{volume: 거래량 데이터 value}

_styles

object

매물분석도에 입힐 스타일

returns -

var styles = {
	area: {
		normal: { color: '#7ca859', opacity: 0.2 }
	},
	line: {
		normal: { color: '#7ca859', width: 0.5}
	},
	text: {
		family: 'dotum', color: '#555555', size: 11
	}
}

deleteAnalysis()

매물분석도 전용 함수 - 삭제

var chart = webponent.chart.init($('.chart01'), options, styles, series);

// 생성
chart.saleAnalysis(10, {volume: 거래량 데이터 value}, {});
// 삭제
chart.deleteAnalysis();

{
	main: {
		s1: {series: 'column', xaxis: 'xaxisKey', yaxis: 'yaxisKey'},

		//...
	}
}