API Docs for: 3.8.0
Show:

File: charts/js/ShapeGroup.js

  1. /**
  2.  * The Charts widget provides an api for displaying data
  3.  * graphically.
  4.  *
  5.  * @module charts
  6.  * @main charts
  7.  */

  9. /**
  10.  * The charts-base submodule contains the core functionality for the charts module.
  11.  *
  12.  * @module charts
  13.  * @submodule charts-base
  14.  */
  15. var CONFIG = Y.config,
  16.     WINDOW = CONFIG.win,
  17.     DOCUMENT = CONFIG.doc,
  18.     Y_Lang = Y.Lang,
  19.     IS_STRING = Y_Lang.isString,
  20.     Y_DOM = Y.DOM,
  21.     LeftAxisLayout,
  22.     RightAxisLayout,
  23.     BottomAxisLayout,
  24.     TopAxisLayout,
  25.     _getClassName = Y.ClassNameManager.getClassName,
  26.     SERIES_MARKER = _getClassName("seriesmarker"),
  27.     ShapeGroup,
  28.     CircleGroup,
  29.     RectGroup,
  30.     EllipseGroup,
  31.     DiamondGroup;

  33. /**
  34.  * Abstract class for creating groups of shapes with the same styles and dimensions.
  35.  *
  36.  * @class ShapeGroup
  37.  * @constructor
  38.  */
  39.  ShapeGroup = function(cfg)
  40.  {
  41.     ShapeGroup.superclass.constructor.apply(this, arguments);
  42.  };

  44.  ShapeGroup.NAME = "shapeGroup";

  46.  Y.extend(ShapeGroup, Y.Path, {
  47.     /**
  48.      * Updates the shape.
  49.      *
  50.      * @method _draw
  51.      * @private
  52.      */
  53.     _draw: function()
  54.     {
  55.         var xvalues = this.get("xvalues"),
  56.             yvalues = this.get("yvalues"),
  57.             x,
  58.             y,
  59.             xRad,
  60.             yRad,
  61.             i = 0,
  62.             len,
  63.             attrs = [],
  64.             dimensions = this.get("dimensions"),
  65.             width = dimensions.width,
  66.             height = dimensions.height,
  67.             radius = dimensions.radius,
  68.             yRadius = dimensions.yRadius,
  69.             id = this.get("id"),
  70.             className = this.node.className,
  71.             widthIsArray = Y_Lang.isArray(width),
  72.             heightIsArray = Y_Lang.isArray(height),
  73.             radiusIsArray = Y_Lang.isArray(radius),
  74.             yRadiusIsArray = Y_Lang.isArray(yRadius);
  75.         if(xvalues && yvalues && xvalues.length > 0)
  76.         {
  77.             this.clear();

  79.             len = xvalues.length;
  80.             for(; i < len; ++i)
  81.             {
  82.                 x = xvalues[i];
  83.                 y = yvalues[i];
  84.                 xRad = radiusIsArray ? radius[i] : radius;
  85.                 yRad = yRadiusIsArray ? yRadius[i] : yRadius;
  86.                 if(!isNaN(x) && !isNaN(y) && !isNaN(xRad))
  87.                 {
  88.                     this.drawShape({
  89.                         x: x,
  90.                         y: y,
  91.                         width: widthIsArray ? width[i] : width,
  92.                         height: heightIsArray ? height[i] : height,
  93.                         radius: xRad,
  94.                         yRadius: yRad
  95.                     });
  96.                     this.closePath();
  97.                     attrs[i] = {
  98.                         id: id + "_" + i,
  99.                         className: className,
  100.                         coords: (x - this._left) + ", " + (y - this._top)  + ", " + radius,
  101.                         shape: "circle"
  102.                     };
  103.                 }
  104.             }
  105.             this._closePath();
  106.         }
  107.     },

  109.     /**
  110.      * Parses and array of lengths into radii
  111.      *
  112.      * @method _getRadiusCollection
  113.      * @param {Array} val Array of lengths
  114.      * @return Array
  115.      * @private
  116.      */
  117.     _getRadiusCollection: function(val)
  118.     {
  119.         var i = 0,
  120.             len = val.length,
  121.             radii = [];
  122.         for(; i < len; ++i)
  123.         {
  124.             radii[i] = val[i] * 0.5;
  125.         }
  126.         return radii;
  127.     }
  128.  });

  130. ShapeGroup.ATTRS = Y.merge(Y.Path.ATTRS, {
  131.     dimensions: {
  132.         getter: function()
  133.         {
  134.             var dimensions = this._dimensions,
  135.                 radius,
  136.                 yRadius,
  137.                 width,
  138.                 height;
  139.             if(dimensions.hasOwnProperty("radius"))
  140.             {
  141.                 return dimensions;
  142.             }
  143.             else
  144.             {
  145.                 width = dimensions.width;
  146.                 height = dimensions.height;
  147.                 radius = Y_Lang.isArray(width) ? this._getRadiusCollection(width) : (width * 0.5);
  148.                 yRadius = Y_Lang.isArray(height) ? this._getRadiusCollection(height) : (height * 0.5);
  149.                 return {
  150.                     width: width,
  151.                     height: height,
  152.                     radius: radius,
  153.                     yRadius: yRadius
  154.                 };
  155.             }
  156.         },

  158.         setter: function(val)
  159.         {
  160.             this._dimensions = val;
  161.             return val;
  162.         }
  163.     },
  164.     xvalues: {
  165.         getter: function()
  166.         {
  167.             return this._xvalues;
  168.         },
  169.         setter: function(val)
  170.         {
  171.             this._xvalues = val;
  172.         }
  173.     },
  174.     yvalues: {
  175.         getter: function()
  176.         {
  177.             return this._yvalues;
  178.         },
  179.         setter: function(val)
  180.         {
  181.             this._yvalues = val;
  182.         }
  183.     }
  184. });
  185. Y.ShapeGroup = ShapeGroup;

  187.