add extjs 6.0.1 sources

[extjs.git] / extjs / packages / charts / src / chart / series / Cartesian.js

/**\r
 * @abstract\r
 * @class Ext.chart.series.Cartesian\r
 * @extends Ext.chart.series.Series\r
 *\r
 * Common base class for series implementations that plot values using cartesian coordinates.\r
 *\r
 * @constructor\r
 */\r
Ext.define('Ext.chart.series.Cartesian', {\r
    extend: 'Ext.chart.series.Series',\r
    config: {\r
        /**\r
         * @cfg {String} xField\r
         * The field used to access the x axis value from the items from the data source.\r
         */\r
        xField: null,\r
\r
        /**\r
         * @cfg {String|String[]} yField\r
         * The field(s) used to access the y-axis value(s) of the items from the data source.\r
         */\r
        yField: null,\r
\r
        /**\r
         * @cfg {Ext.chart.axis.Axis|Number|String}\r
         * xAxis The chart axis the series is bound to in the 'X' direction.\r
         * Normally, this would be set automatically by the series.\r
         * For charts with multiple x-axes, this defines which x-axis is used by the series.\r
         * It refers to either axis' ID or the (zero-based) index of the axis\r
         * in the chart's {@link Ext.chart.AbstractChart#axes axes} config.\r
         */\r
        xAxis: null,\r
\r
        /**\r
         * @cfg {Ext.chart.axis.Axis|Number|String}\r
         * yAxis The chart axis the series is bound to in the 'Y' direction.\r
         * Normally, this would be set automatically by the series.\r
         * For charts with multiple y-axes, this defines which y-axis is used by the series.\r
         * It refers to either axis' ID or the (zero-based) index of the axis\r
         * in the chart's {@link Ext.chart.AbstractChart#axes axes} config.\r
         */\r
        yAxis: null\r
    },\r
\r
    directions: ['X', 'Y'],\r
\r
    /**\r
     * @private\r
     *\r
     * Tells which store record fields should be used for a specific axis direction. E.g. for\r
     *\r
     *     fieldCategory<direction>: ['<fieldConfig1>', '<fieldConfig2>', ...]\r
     *\r
     * the field names from the following configs will be used:\r
     *\r
     *     series.<fieldConfig1>Field, series.<fieldConfig2>Field, ...\r
     *\r
     */\r
    fieldCategoryX: ['X'],\r
    fieldCategoryY: ['Y'],\r
\r
    applyXAxis: function (newAxis, oldAxis) {\r
        return this.getChart().getAxis(newAxis) || oldAxis;\r
    },\r
\r
    applyYAxis: function (newAxis, oldAxis) {\r
        return this.getChart().getAxis(newAxis) || oldAxis;\r
    },\r
\r
    updateXAxis: function (axis) {\r
        axis.processData(this);\r
    },\r
\r
    updateYAxis: function (axis) {\r
        axis.processData(this);\r
    },\r
\r
    coordinateX: function () {\r
        return this.coordinate('X', 0, 2);\r
    },\r
\r
    coordinateY: function () {\r
        return this.coordinate('Y', 1, 2);\r
    },\r
\r
    getItemForPoint: function (x, y) {\r
        if (this.getSprites()) {\r
            var me = this,\r
                sprite = me.getSprites()[0],\r
                store = me.getStore(),\r
                item, index;\r
\r
            if (me.getHidden()) {\r
                return null;\r
            }\r
            if (sprite) {\r
                index = sprite.getIndexNearPoint(x, y);\r
                if (index !== -1) {\r
                    item = {\r
                        series: me,\r
                        category: me.getItemInstancing() ? 'items' : 'markers',\r
                        index: index,\r
                        record: store.getData().items[index],\r
                        field: me.getYField(),\r
                        sprite: sprite\r
                    };\r
                    return item;\r
                }\r
            }\r
        }\r
    },\r
\r
    createSprite: function () {\r
        var me = this,\r
            sprite = me.callParent(),\r
            chart = me.getChart(),\r
            xAxis = me.getXAxis();\r
\r
        sprite.setAttributes({\r
            flipXY: chart.getFlipXY(),\r
            xAxis: xAxis\r
        });\r
        if (sprite.setAggregator && xAxis && xAxis.getAggregator) {\r
            if (xAxis.getAggregator) {\r
                sprite.setAggregator({strategy: xAxis.getAggregator()});\r
            } else {\r
                sprite.setAggregator({});\r
            }\r
        }\r
        return sprite;\r
    },\r
\r
    getSprites: function () {\r
        var me = this,\r
            chart = this.getChart(),\r
            animation = me.getAnimation() || chart && chart.getAnimation(),\r
            itemInstancing = me.getItemInstancing(),\r
            sprites = me.sprites,\r
            sprite;\r
\r
        if (!chart) {\r
            return [];\r
        }\r
\r
        if (!sprites.length) {\r
            sprite = me.createSprite();\r
        } else {\r
            sprite = sprites[0];\r
        }\r
\r
        if (animation) {\r
            if (itemInstancing) {\r
                sprite.itemsMarker.getTemplate().setAnimation(animation);\r
            }\r
            sprite.setAnimation(animation);\r
        }\r
        return sprites;\r
    },\r
\r
    provideLegendInfo: function (target) {\r
        var me = this,\r
            style = me.getSubStyleWithTheme(),\r
            fill = style.fillStyle;\r
\r
        if (Ext.isArray(fill)) {\r
            fill = fill[0];\r
        }\r
        target.push({\r
            name: me.getTitle() || me.getYField() || me.getId(),\r
            mark: (Ext.isObject(fill) ? fill.stops && fill.stops[0].color : fill) || style.strokeStyle || 'black',\r
            disabled: me.getHidden(),\r
            series: me.getId(),\r
            index: 0\r
        });\r
    },\r
\r
    getXRange: function () {\r
        return [this.dataRange[0], this.dataRange[2]];\r
    },\r
\r
    getYRange: function () {\r
        return [this.dataRange[1], this.dataRange[3]];\r
    }\r
})\r
;