realchart 1.1.8 → 1.1.11

package/dist/index.d.ts

@@ -254,6 +254,11 @@ interface SVGStyles {
      * {@page config.seires.bar 'bar'} 시리즈의 데이터포인트 bar의 모서리를 지정하는 데 사용된다.
      */
     rx?: string;
+    /**
+     * **SVG에 적용되는 정식 css style 속성이 아니다.**<br/>
+     * 데이터포인트 라벨등 몇 요소의 배경 간격 설정으로 사용할 수 있다.
+     */
+    padding?: string;
     /**
      * 텍스트 정렬을 지정한다.<br/>
      * **SVG에 적용되는 정식 css style 속성이 아니다.**
@@ -867,6 +872,57 @@ declare const AnnotationTypes: {
 type AnnotationType = typeof AnnotationTypes[keyof typeof AnnotationTypes];
 type AnnotationOptionsType = ImageAnnotationOptions | ShapeAnnotationOptions | TextAnnotationOptions;
 
+/**
+ * 차트 내보내기 설정 모델
+ * @config chart.exporting
+ */
+interface ExporterOptions extends ChartItemOptions {
+    /**
+     * 내보내기 버튼 표시 여부 지정
+     */
+    visible?: boolean;
+    /**
+     * 내보내기 버튼을 사용해 내보낸 차트에 사용할 확장자 없는 파일 이름.\
+     * 'export' 함수를 호출할 때 fileName을 지정하지 않을 경우 이 속성이 적용된다.
+     * fileName을 지정하지 않을 경우 realchart.type으로 다운로드 된다.
+     *
+     */
+    fileName?: string;
+    /**
+     * 내보내기를 라이브러리를 사용하여 진행할지 여부 지정
+     */
+    useLibrary?: boolean;
+    /**
+     * 내보내기 메뉴에 포함할 export types
+     */
+    menus?: ExportType[];
+    /**
+     * 너비, 지정한 너비에 맞춰 높이가 결정된다.
+     */
+    width?: number;
+    /**
+     * 이미지의 scale
+     */
+    scale?: number;
+    /**
+     * 내보내기 도중 에러가 발생했을 때 처리할 서버 URL.\
+     * 지정하지 않을경우 realchart 서버에서 처리한다.
+     */
+    url?: string;
+    /**
+     * true로 지정하면 내보내기 결과에 {@page config.axis.scrollBar AxisScrollBarOptions}가 포함되지 않는다.
+     */
+    hideScrollbar?: boolean;
+    /**
+     * true로 지정하면 내보내기 결과에 {@page config.seriesNavigator SeriesNavigator}가 포함되지 않는다.
+     */
+    hideNavigator?: boolean;
+    /**
+     * true로 지정하면 내보내기 결과에 {@page config.body.zoomButton ZoomButtonOptions}가 포함되지 않는다.
+     */
+    hideZoomButton?: boolean;
+}
+
 /**
  * @enum
  */
@@ -901,6 +957,15 @@ interface ExportOptions {
      */
     fileName?: string;
 }
+/**
+ * 외부 모듈로 구현되는 차트 내보내기 기능 명세.
+ */
+interface ChartExporter {
+    exportToImage: (dom: HTMLElement, options: ExportOptions, config: ExporterOptions) => void;
+    exportToPrint: (dom: HTMLElement, options: ExportOptions) => void;
+    isContextMenuVisible: () => boolean;
+    toggleContextMenu: () => void;
+}
 
 interface IRect {
     x: number;
@@ -1110,6 +1175,7 @@ declare class RcElement extends RcObject {
     trans(x: number, y: number): RcElement;
     transp(p: Point): RcElement;
     transEx(x: number, y: number, duration?: number, invalidate?: boolean): RcElement;
+    transEx2(x: number, y: number, duration?: number, invalidate?: boolean): RcElement;
     transX(x: number): RcElement;
     transY(y: number): RcElement;
     /**
@@ -1317,6 +1383,10 @@ interface DataPointLabelOptions extends IconedTextOptions {
      *
      */
     textField?: string;
+    /**
+     * polar일때 true로 지정할 경우 각도에 따라 자동으로 회전 시킨다.
+     */
+    autoRotation?: boolean;
     /**
      * 계산되는 기본 text 대신, data point label로 표시될 text 리턴.<br/>
      * undefined나 null을 리턴하면 {@page textField} 등을 사용한 기존에 표시될 텍스트를 사용한다.
@@ -3114,7 +3184,7 @@ interface PieSeriesLabelOptions extends DataPointLabelOptions {
      * @override
      * @default true
      */
-    visible: boolean;
+    visible?: boolean;
 }
 declare const PieSeriesType = "pie";
 /**
@@ -5295,6 +5365,21 @@ declare abstract class Series<OP extends SeriesOptions = SeriesOptions> extends
      * 시리즈에 설정된 데이터포인트들 중 표시 중인 것들의 개수.<br/>
      */
     get visiblePointCount(): number;
+    /**
+     * 시리즈에 설정된 데이터포인트들 중 표시 중인 것들의 목록.<br/>
+     */
+    get visiblePoints(): DataPoint[];
+    /**
+     * polar가 적용 가능한 시리즈 인지.
+     */
+    get canPolar(): boolean;
+    /**
+     * 시리즈에 설정된 데이터포인트들 중 표시 중인 index번째 포인트 객체.<br/>
+     *
+     * @param index
+     * @returns
+     */
+    getVisiblePoint(index: number): DataPoint;
     contains(p: DataPoint): boolean;
     getPoints(): DataPointCollection;
     _getLabeledPoints(): DataPoint[];
@@ -6474,7 +6559,7 @@ interface AxisLineOptions extends AxisItemOptions {
      *
      * @default undefined
      */
-    visible: boolean;
+    visible?: boolean;
 }
 /**
  * 부채꼴 polar 좌표계의 X 축일 때 원호의 양 끝과 중심에 연결되는 선분들의 설정모델.<br/>
@@ -6680,11 +6765,12 @@ interface AxisLabelOptions extends IconedTextOptions {
      */
     maxRows?: number;
     /**
-     * 수평 축일 때, tick label 표시 회전 각도.<br/>
-     * -90 ~ 90 사이의 각도로 지정할 수 있다.
-     *
+     * {@page chart.polar}가 아닌 수평 축일 때, tick label 표시 회전 각도.<br/>
+     * -90 ~ 90 사이의 각도로 지정할 수 있다.<br/>
+     * **'auto'**이면 polar일때는 label위치에 따라 각도가 자동으로 계산되고,
+     * polar가 아닐때는 {@page AxisLabelArrange}속성에 따라 결정된다.
      */
-    rotation?: number;
+    rotation?: number | 'auto';
     /**
      * 기본 설정이나 {@page step}, {@page rows}, {@page rotation} 속성들을 명시적으로 설정한 경우에도
      * label들이 본래 차지하는 공간을 초과할 때,
@@ -6975,7 +7061,7 @@ interface CrosshairOptions extends ChartItemOptions {
      * @override
      * @default false
      */
-    visible: boolean;
+    visible?: boolean;
     /**
      * 축 상에 crosshair의 정보를 표시하는 view.
      *
@@ -7605,7 +7691,7 @@ interface TimeAxisTickOptions extends ContinuousAxisTickOptions {
      * @append
      * 단위가 지정된 문자열로 지정하는 경우 값이 -1 이하이거나 1 이상이어야 한다. // #141
      */
-    stepInterval: number;
+    stepInterval?: number;
 }
 declare const TimeAxisType = "time";
 /**
@@ -7629,57 +7715,6 @@ interface TimeAxisOptions extends ContinuousAxisOptions {
 }
 type AxisOptionsType = CategoryAxisOptions | LinearAxisOptions | LogAxisOptions | TimeAxisOptions;
 
-/**
- * 차트 내보내기 설정 모델
- * @config chart.exporting
- */
-interface ExporterOptions extends ChartItemOptions {
-    /**
-     * 내보내기 버튼 표시 여부 지정
-     */
-    visible?: boolean;
-    /**
-     * 내보내기 버튼을 사용해 내보낸 차트에 사용할 확장자 없는 파일 이름.\
-     * 'export' 함수를 호출할 때 fileName을 지정하지 않을 경우 이 속성이 적용된다.
-     * fileName을 지정하지 않을 경우 realchart.type으로 다운로드 된다.
-     *
-     */
-    fileName?: string;
-    /**
-     * 내보내기를 라이브러리를 사용하여 진행할지 여부 지정
-     */
-    useLibrary?: boolean;
-    /**
-     * 내보내기 메뉴에 포함할 export types
-     */
-    menus?: ExportType[];
-    /**
-     * 너비, 지정한 너비에 맞춰 높이가 결정된다.
-     */
-    width?: number;
-    /**
-     * 이미지의 scale
-     */
-    scale?: number;
-    /**
-     * 내보내기 도중 에러가 발생했을 때 처리할 서버 URL.\
-     * 지정하지 않을경우 realchart 서버에서 처리한다.
-     */
-    url?: string;
-    /**
-     * true로 지정하면 내보내기 결과에 {@page config.axis.scrollBar AxisScrollBarOptions}가 포함되지 않는다.
-     */
-    hideScrollbar?: boolean;
-    /**
-     * true로 지정하면 내보내기 결과에 {@page config.seriesNavigator SeriesNavigator}가 포함되지 않는다.
-     */
-    hideNavigator?: boolean;
-    /**
-     * true로 지정하면 내보내기 결과에 {@page config.body.zoomButton ZoomButtonOptions}가 포함되지 않는다.
-     */
-    hideZoomButton?: boolean;
-}
-
 /**
  * 단일 값을 다양한 방식으로 표시한다.<br/>
  * 또, 단일 계이지들을 여러 개 묶어서 관련된 값을 표시할 수도 있다.
@@ -9380,6 +9415,13 @@ declare class Body<OP extends BodyOptions = BodyOptions> extends ChartItem<OP> i
  */
 declare class Exporter extends ChartItem<ExporterOptions> {
     static defaults: ExporterOptions;
+    private _module;
+    private _isCompose;
+    isCompose(): boolean;
+    compose(exporter: ChartExporter): void;
+    isContextMenuVisible(): boolean;
+    toggleContextMenu(): void;
+    exportToImage(dom: any, options: any, exporting: any): void;
 }
 
 declare class NavigiatorHandle extends ChartItem<NavigiatorHandleOptions> {
@@ -10779,6 +10821,7 @@ declare class LineSeries<OP extends LineSeriesOptions = LineSeriesOptions> exten
     get flag(): LineSeriesFlag;
     backDir(): LineStepDirection;
     isMarker(): boolean;
+    get canPolar(): boolean;
     getLineType(): LineType;
     getBaseValue(axis: IAxis): number;
     protected _doPrepareRender(): void;
@@ -10792,6 +10835,7 @@ declare class LineSeries<OP extends LineSeriesOptions = LineSeriesOptions> exten
  */
 declare class SplineSeries extends LineSeries<SplineSeriesOptions> {
     static readonly type = "spline";
+    get canPolar(): boolean;
     _viewType(): string;
     getLineType(): LineType;
 }
@@ -10899,6 +10943,7 @@ declare abstract class BarSeriesBase<OP extends BarSeriesBaseOptions = BarSeries
 declare class BarSeries extends BarSeriesBase<BarSeriesOptions> {
     static readonly type = "bar";
     protected _createLegendMarker(doc: Document, size: number): RcElement;
+    get canPolar(): boolean;
 }
 /**
  * {@page BarSeries}, {@page CircleBarSeires}의 그룹 기반 모델.
@@ -11028,6 +11073,7 @@ declare class BubbleSeries extends MarkerSeries<BubbleSeriesOptions> {
     protected _doApply(options: BubbleSeriesOptions): void;
     protected _createPoint(source: any): DataPoint;
     protected _getNoClip(polar: boolean): boolean;
+    get canPolar(): boolean;
     hasZ(): boolean;
     _colorByPoint(): boolean;
     protected _doPrepareRender(): void;
@@ -11388,6 +11434,7 @@ declare class ScatterSeries extends MarkerSeries<ScatterSeriesOptions> {
      * rendering 시점에 chart가 series별로 기본 shape를 지정한다.
      */
     setShape(shape: Shape): void;
+    get canPolar(): boolean;
     getShape(p: ScatterSeriesPoint): Shape;
     hasShape(): boolean;
     legendMarker(doc: Document, size: number): RcElement;