LineSeries.js revision 11174dd4aa7b6152555e21e3e0a5a511e058415b
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp/**
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * The LineSeries class renders quantitative data on a graph by connecting relevant data points.
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @class LineSeries
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @extends CartesianSeries
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @uses Lines
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @constructor
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp */
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTrippY.LineSeries = Y.Base.create("lineSeries", Y.CartesianSeries, [Y.Lines], {
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp /**
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @protected
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @method drawSeries
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp */
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp drawSeries: function()
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp {
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp this.get("graphic").clear();
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp this.drawLines();
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp },
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp /**
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @protected
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * Method used by <code>styles</code> setter. Overrides base implementation.
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @method _setStyles
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @param {Object} newStyles Hash of properties to update.
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @return Object
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp */
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp _setStyles: function(val)
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp {
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp if(!val.line)
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp {
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp val = {line:val};
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp }
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp return Y.LineSeries.superclass._setStyles.apply(this, [val]);
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp },
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp /**
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @protected
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * Gets the default value for the <code>styles</code> attribute. Overrides
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * base implementation.
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @method _getDefaultStyles
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @return Object
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp */
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp _getDefaultStyles: function()
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp {
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp var styles = this._mergeStyles({line:this._getLineDefaults()}, Y.LineSeries.superclass._getDefaultStyles());
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp return styles;
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp }
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp},
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp{
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp ATTRS: {
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp /**
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * Read-only attribute indicating the type of series.
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @attribute type
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @type String
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp * @default line
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp */
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp type: {
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp value:"line"
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp }
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp /**
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * Style properties used for drawing lines. This attribute is inherited from <code>Renderer</code>. Below are the default values:
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * <dl>
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * <dt>color</dt><dd>The color of the line. The default value is determined by the order of the series on the graph. The color will be
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp * retrieved from the following array:
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * <code>["#426ab3", "#d09b2c", "#000000", "#b82837", "#b384b5", "#ff7200", "#779de3", "#cbc8ba", "#7ed7a6", "#007a6c"]</code>
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * <dt>weight</dt><dd>Number that indicates the width of the line. The default value is 6.</dd>
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * <dt>alpha</dt><dd>Number between 0 and 1 that indicates the opacity of the line. The default value is 1.</dd>
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp * <dt>lineType</dt><dd>Indicates whether the line is solid or dashed. The default value is solid.</dd>
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp * <dt>dashLength</dt><dd>When the <code>lineType</code> is dashed, indicates the length of the dash. The default value is 10.</dd>
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * <dt>gapSpace</dt><dd>When the <code>lineType</code> is dashed, indicates the distance between dashes. The default value is 10.</dd>
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * <dt>connectDiscontinuousPoints</dt><dd>Indicates whether or not to connect lines when there is a missing or null value between points. The default value is true.</dd>
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp * <dt>discontinuousType</dt><dd>Indicates whether the line between discontinuous points is solid or dashed. The default value is solid.</dd>
8209f3939e32e0e5bde64192267fdaf9db6f4fbcTripp * <dt>discontinuousDashLength</dt><dd>When the <code>discontinuousType</code> is dashed, indicates the length of the dash. The default value is 10.</dd>
11174dd4aa7b6152555e21e3e0a5a511e058415bTripp * <dt>discontinuousGapSpace</dt><dd>When the <code>discontinuousType</code> is dashed, indicates the distance between dashes. The default value is 10.</dd>
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * </dl>
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp *
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @attribute styles
8648721e29bb657dd5c5ff20f03e86fe50628ce6Tripp * @type Object
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp */
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp }
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp});
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp
e393eced613f9b4a5fb6bdd461d0e0bf5064d5ecTripp