add extjs 6.0.1 sources

[extjs.git] / extjs / packages / charts / src / chart / axis / Axis3D.js

/**\r
 * @class Ext.chart.axis.Axis3D\r
 * @extends Ext.chart.axis.Axis\r
 * @xtype axis3d\r
 *\r
 * Defines a 3D axis for charts.\r
 *\r
 * A 3D axis has the same properties as the regular {@link Ext.chart.axis.Axis axis},\r
 * plus a notion of depth. The depth of the 3D axis is determined automatically\r
 * based on the depth of the bound series.\r
 *\r
 * This type of axis has the following limitations compared to the regular axis class:\r
 * - supported {@link Ext.chart.axis.Axis#position positions} are 'left' and 'bottom' only;\r
 * - floating axes are not supported.\r
 *\r
 * At the present moment only {@link Ext.chart.series.Bar3D} series can make use of the 3D axis.\r
 */\r
Ext.define('Ext.chart.axis.Axis3D', {\r
    extend: 'Ext.chart.axis.Axis',\r
    xtype: 'axis3d',\r
\r
    requires: [\r
        'Ext.chart.axis.sprite.Axis3D'\r
    ],\r
\r
    config: {\r
        /**\r
         * @private\r
         * The depth of the axis. Determined automatically.\r
         */\r
        depth: 0\r
\r
        /**\r
         * @cfg {String} position\r
         * Where to set the axis. Available options are `left` and `bottom`.\r
         */\r
    },\r
\r
    onSeriesChange: function (chart) {\r
        var me = this,\r
            eventName = 'depthchange',\r
            listenerName = 'onSeriesDepthChange',\r
            i, series;\r
\r
        function toggle(action) {\r
            var boundSeries = me.boundSeries;\r
            for (i = 0; i < boundSeries.length; i++) {\r
                series = boundSeries[i];\r
                series[action](eventName, listenerName, me);\r
            }\r
        }\r
\r
        // Remove 'depthchange' listeners from old bound series, if any.\r
        toggle('un');\r
\r
        me.callParent(arguments);\r
\r
        // Add 'depthchange' listeners to new bound series.\r
        toggle('on');\r
    },\r
\r
    onSeriesDepthChange: function (series, depth) {\r
        var me = this,\r
            maxDepth = depth,\r
            boundSeries = me.boundSeries,\r
            i, item;\r
\r
        if (depth > me.getDepth()) {\r
            maxDepth = depth;\r
        } else {\r
            for (i = 0; i < boundSeries.length; i++) {\r
                item = boundSeries[i];\r
                if (item !== series && item.getDepth) {\r
                    depth = item.getDepth();\r
                    if (depth > maxDepth) {\r
                        maxDepth = depth;\r
                    }\r
                }\r
            }\r
        }\r
        me.setDepth(maxDepth);\r
    },\r
\r
    updateDepth: function (depth) {\r
        var me = this,\r
            sprites = me.getSprites(),\r
            attr = {depth: depth};\r
\r
        if (sprites && sprites.length) {\r
            sprites[0].setAttributes(attr);\r
        }\r
        if (me.gridSpriteEven && me.gridSpriteOdd) {\r
            me.gridSpriteEven.getTemplate().setAttributes(attr);\r
            me.gridSpriteOdd.getTemplate().setAttributes(attr);\r
        }\r
    },\r
\r
    getGridAlignment: function () {\r
        switch (this.getPosition()) {\r
            case 'left':\r
            case 'right':\r
                return 'horizontal3d';\r
            case 'top':\r
            case 'bottom':\r
                return 'vertical3d';\r
        }\r
    }\r
\r
});