realchart 0.9.4 → 0.9.5

package/README.md

@@ -23,45 +23,33 @@ const chart = RealChart.createChart(document, 'realchart', config);
 ```ts
 // config
 const config = {
-    options: {
-        animatable: false
-    },
-    title: "Basic Real-Chart",
-    legend: true,
-    xAxis: {
-        title: 'X Axis',
-        grid: true
-    },
-    yAxis: {
-        title: 'Y Axis',
-    },
-    series: {
-        pointLabel: {
-            visible: true,
-            effect: 'outline',
-            style: {
-            },
-        },
-        data: [
-            ['home', 7], 
-            ['sky', 11], 
-            ['def', 9], 
-            ['소홍', 10], 
-            ['지리산', 14.3], 
-            ['zzz', 13],
-            ['낙동강', 12.5]
-        ],
-        data2: [
-            [1, 7], 
-            [2, 11], 
-            [3, 9], 
-            [4, 10], 
-            [5, 14.3], 
-            [6, 13],
-            [7, 12.5]
-        ],
-    }
-}
+  options: {},
+  title: "Axis Breaks",
+  xAxis: {
+    title: "일일 Daily fat",
+    categories: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
+    grid: true
+  },
+  yAxis: {
+    title: "Vertical 수직축 Axis",
+    break: [{
+      from: 500,
+      to: 3000,
+      inclusive: false,
+      space: 5
+    }]
+  },
+  series: [{
+    name: 'column1',
+    pointLabel: true,
+    data: [499, 128, 180, 345, 3050, 3590, 3840, 3630, 3120, 520, 240, 80]
+  }, {
+    name: 'column3',
+    pointLabel: true,
+    data: [64, 138, 164, 408, 3120, 3540, 3875, 3420, 720, 320, 160, 20]
+  }]
+};
+const chart = RealChart.createChart(document, 'realchart', config);
 ```
 ### styles
 

package/dist/index.d.ts

@@ -54,10 +54,10 @@ declare enum VerticalAlign {
     BOTTOM = "bottom"
 }
 declare enum SectionDir {
-    LEFT = 0,
-    TOP = 1,
-    BOTTOM = 2,
-    RIGHT = 3
+    LEFT = "left",
+    TOP = "top",
+    BOTTOM = "bottom",
+    RIGHT = "right"
 }
 declare enum AlignBase {
     CHART = "chart",
@@ -90,6 +90,7 @@ interface IPointerHandler {
 declare abstract class RcControl extends RcWrappableObject {
     static readonly CLASS_NAME = "rct-control";
     static readonly SHADOW_FILTER = "rr-chart-shadow-filter";
+    static _animatable: boolean;
     private _container;
     private _dom;
     private _htmlRoot;
@@ -101,7 +102,6 @@ declare abstract class RcControl extends RcWrappableObject {
     private _testing;
     private _dirty;
     private _requestTimer;
-    private _invalidElements;
     private _toAnimation;
     private _invalidateLock;
     private _lockDirty;
@@ -407,12 +407,15 @@ declare abstract class ChartItem extends RcObject {
     set visible(value: boolean);
     style: SVGStyleOrClass;
     load(source: any): ChartItem;
+    update(source: any): ChartItem;
     prepareRender(): void;
     protected _changed(): void;
     protected _doLoadSimple(source: any): boolean;
     protected _getDefObjProps(prop: string): any;
     protected _doLoad(source: any): void;
     protected _doLoadProp(prop: string, value: any): boolean;
+    protected _doUpdateSimple(source: any): boolean;
+    protected _doUpdate(source: any): boolean;
     protected _doPrepareRender(chart: IChart): void;
 }
 declare enum ChartTextEffect {
@@ -489,12 +492,13 @@ interface IPointPos {
 }
 declare class DataPoint {
     static swap(pts: IPointPos[]): IPointPos[];
-    source: any;
     index: number;
     vindex: number;
     x: any;
     y: any;
+    series: string | number;
     readonly pid: number;
+    source: any;
     isNull: boolean;
     xValue: number;
     yValue: number;
@@ -509,11 +513,13 @@ declare class DataPoint {
     get xAbs(): number;
     ariaHint(): string;
     labelCount(): number;
+    assignTo(proxy: any): void;
     getProp(fld: string | number): any;
     parse(series: ISeries): void;
     getLabel(index: number): any;
     getValueOf: (traget: any, param: string) => any;
     swap(): void;
+    protected _assignTo(proxy: any): any;
     protected _colorIndex(): number;
     protected _readArray(series: ISeries, v: any[]): void;
     protected _readObject(series: ISeries, v: any): void;
@@ -536,12 +542,14 @@ declare class DataPointCollection {
 
 interface ILegendSource {
     visible: boolean;
+    legendMarker(): RcElement;
     legendColor(): string;
     legendLabel(): string;
 }
 declare class LegendItem extends ChartItem {
     legend: Legend;
     source: ILegendSource;
+    static readonly MARKER_SIZE = 12;
     constructor(legend: Legend, source: ILegendSource);
     text(): string;
 }
@@ -586,6 +594,10 @@ declare class Legend extends ChartItem {
     getLayout(): LegendLayout;
     getMaxWidth(domain: number): number;
     getMaxHeight(domain: number): number;
+    getLeft(doamin: number): number;
+    getRight(doamin: number): number;
+    getTop(doamin: number): number;
+    getBottom(doamin: number): number;
     protected _doLoad(src: any): void;
     protected _doPrepareRender(chart: IChart): void;
     private $_collectItems;
@@ -620,6 +632,7 @@ declare class DataPointLabel extends FormattableText {
     distance: number;
     constructor(chart: IChart);
     getText(value: any): string;
+    protected _doLoad(source: any): void;
 }
 interface IPlottingItem {
     index: number;
@@ -710,7 +723,7 @@ interface ISeries extends IPlottingItem {
     getValue(point: DataPoint, axis: IAxis): number;
     isVisible(p: DataPoint): boolean;
 }
-interface IPointStyleArgs {
+interface IPointStyleCallbackArgs {
     series: string | number;
     count: number;
     vcount: number;
@@ -723,7 +736,7 @@ interface IPointStyleArgs {
     xValue: any;
     yValue: any;
 }
-type PointStyleCallback = (args: IPointStyleArgs) => SVGStyleOrClass;
+type PointStyleCallback = (args: IPointStyleCallbackArgs) => SVGStyleOrClass;
 declare abstract class Series extends ChartItem implements ISeries, ILegendSource {
     static _loadSeries(chart: IChart, src: any, defType?: string): Series;
     readonly name: string;
@@ -741,7 +754,8 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     _maxValue: number;
     _referents: Series[];
     _calcedColor: string;
-    protected _pointArgs: IPointStyleArgs;
+    private _legendMarker;
+    protected _pointArgs: IPointStyleCallbackArgs;
     constructor(chart: IChart, name?: string);
     abstract _type(): string;
     zOrder: number;
@@ -756,6 +770,7 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     color: string;
     pointColors: boolean | string[];
     clipped: boolean;
+    displayInLegend: boolean;
     pointStyleCallback: PointStyleCallback;
     contains(p: DataPoint): boolean;
     getPoints(): DataPointCollection;
@@ -768,6 +783,8 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     defaultYAxisType(): string;
     clusterable(): boolean;
     displayName(): string;
+    legendMarker(): RcElement;
+    setLegendMarker(elt: RcElement): void;
     legendColor(): string;
     legendLabel(): string;
     ignoreAxisBase(axis: IAxis): boolean;
@@ -794,9 +811,9 @@ declare abstract class Series extends ChartItem implements ISeries, ILegendSourc
     getLabelOff(off: number): number;
     referBy(ref: Series): void;
     setPointVisible(p: DataPoint, visible: boolean): void;
-    protected _createPointArgs(): IPointStyleArgs;
-    protected _preparePointArgs(args: IPointStyleArgs): void;
-    protected _getPointStyleArgs(args: IPointStyleArgs, p: DataPoint): void;
+    protected _createPointArgs(): IPointStyleCallbackArgs;
+    protected _preparePointArgs(args: IPointStyleCallbackArgs): void;
+    protected _getPointStyleArgs(args: IPointStyleCallbackArgs, p: DataPoint): void;
     getPointStyle(p: DataPoint): any;
     _referOtherSeries(series: Series): boolean;
     protected _getField(axis: IAxis): any;
@@ -852,6 +869,7 @@ declare abstract class SeriesGroup<T extends Series> extends ChartItem implement
     layout: SeriesGroupLayout;
     xAxis: string | number;
     yAxis: string | number;
+    displayInLegend: boolean;
     get series(): T[];
     needAxes(): boolean;
     isEmpty(): boolean;
@@ -1013,6 +1031,7 @@ declare abstract class Axis extends ChartItem implements IAxis {
     protected abstract _createLabelModel(): AxisLabel;
     protected abstract _doPrepareRender(): void;
     protected abstract _doBuildTicks(min: number, max: number, length: number): IAxisTick[];
+    isBased(): boolean;
     disconnect(): void;
     collectValues(): void;
     collectReferentsValues(): void;
@@ -1164,6 +1183,7 @@ declare class ChartOptions extends ChartItem {
     credits: Credits;
 }
 interface IChartEventListener {
+    onModelChanged?(chart: Chart, item: ChartItem): void;
     onVisibleChanged?(chart: Chart, item: ChartItem): void;
     onPointVisibleChange?(chart: Chart, series: Series, point: DataPoint): void;
 }
@@ -1225,9 +1245,9 @@ declare class Chart extends RcEventProvider<IChartEventListener> implements ICha
     _getSeriesType(type: string): any;
     _getAxisType(type: string): any;
     getAxesGap(): number;
+    _modelChanged(item: ChartItem): void;
     _visibleChanged(item: ChartItem): void;
     _pointVisibleChanged(series: Series, point: DataPoint): void;
-    _modelChanged(item: ChartItem): void;
 }
 
 declare abstract class GroupElement extends RcElement {
@@ -1282,6 +1302,7 @@ declare abstract class ChartElement<T extends ChartItem> extends RcElement {
     _debugRect: RectElement;
     constructor(doc: Document, styleName?: any);
     chart(): IChart;
+    protected _prepareStyleOrClass(model: T): void;
     measure(doc: Document, model: T, hintWidth: number, hintHeight: number, phase: number): ISize;
     layout(param?: any): ChartElement<ChartItem>;
     resizeByMeasured(): ChartElement<ChartItem>;
@@ -1409,9 +1430,11 @@ type LabelLayoutInfo = {
 declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
     static readonly POINT_CLASS = "rct-point";
     static readonly DATA_FOUCS = "focus";
+    static readonly LEGEND_MARKER = "rct-legend-item-marker";
     protected _pointContainer: PointContainer;
     protected _labelContainer: PointLabelContainer;
     private _trendLineView;
+    protected _legendMarker: RcElement;
     protected _visPoints: DataPoint[];
     protected _inverted: boolean;
     protected _animatable: boolean;
@@ -1432,13 +1455,17 @@ declare abstract class SeriesView<T extends Series> extends ChartElement<T> {
     clicked(elt: Element): void;
     protected _doPointClicked(view: IPointView): void;
     protected _getColor(): string;
+    prepareSeries(doc: Document, model: T): void;
+    protected _prepareStyleOrClass(model: T): void;
     protected _doMeasure(doc: Document, model: T, hintWidth: number, hintHeight: number, phase: number): ISize;
     protected _doLayout(): void;
     protected abstract _prepareSeries(doc: Document, model: T): void;
     protected abstract _renderSeries(width: number, height: number): void;
-    protected _prepareVisPoints(model: T): DataPoint[];
+    protected _getLegendMarker(doc: Document): RcElement;
+    protected _createLegendMarker(doc: Document, size: number): RcElement;
+    protected _collectVisPoints(model: T): DataPoint[];
     private $_setColorIndex;
-    protected _setPointStyle(v: RcElement, p: DataPoint, styles?: any[]): void;
+    protected _setPointStyle(v: RcElement, model: T, p: DataPoint, styles?: any[]): void;
     protected _labelViews(): PointLabelContainer;
     protected _getViewRate(): number;
     protected _animating(): boolean;
@@ -1510,6 +1537,7 @@ declare class BodyView extends ChartElement<Body> {
     private _crosshairLines;
     private _focused;
     constructor(doc: Document, owner: IPlottingOwner);
+    prepareSeries(doc: Document, chart: IChart): void;
     prepareGuideContainers(): void;
     pointerMoved(p: IPoint, target: EventTarget): void;
     private $_setFocused;
@@ -1584,6 +1612,7 @@ declare class ChartControl extends RcControl implements IChartEventListener {
     private _model;
     private _chartView;
     constructor(doc: Document, container: string | HTMLDivElement);
+    onModelChanged(chart: Chart, item: ChartItem): void;
     onVisibleChanged(chart: Chart, item: ChartItem): void;
     onPointVisibleChanged(chart: Chart, series: Series, point: DataPoint): void;
     get model(): Chart;
@@ -1606,11 +1635,13 @@ declare class RcChartControl {
 declare class Globals {
     static getVersion(): string;
     static setDebugging(debug: boolean): void;
+    static setAnimatable(value: boolean): void;
     static createChart(doc: Document, container: string | HTMLDivElement, config: any): RcChartControl;
 }
 
 declare const getVersion: typeof Globals.getVersion;
 declare const setDebugging: typeof Globals.setDebugging;
+declare const setAnimatable: typeof Globals.setAnimatable;
 declare const createChart: typeof Globals.createChart;
 
-export { RcChartControl, createChart, getVersion, setDebugging };
+export { RcChartControl, createChart, getVersion, setAnimatable, setDebugging };