feat(gauge): Intent to ship stack data

demo/demo.js

@@ -3261,7 +3261,7 @@ d3.select(".chart_area")
 				}
 			}
 		},
-		MultilneTitle: {
+		MultilineTitle: {
 			options: {
 				data: {
 					columns: [
@@ -3322,7 +3322,49 @@ d3.select(".chart_area")
 					}
 				}
 			}
-		}
+		},
+		GaugeStackData: [
+			{
+				options: {
+					data: {
+						columns: [
+							["data1", 30, 10],
+							["data2", 190],
+							["data3", 70],
+							["data4", 150],
+							["data5", 50]
+						],
+						type: "gauge",
+						order: "asc"
+					},
+					gauge: {
+						title: "Title A"
+					}
+				}
+			},
+			{
+				options: {
+					data: {
+						columns: [
+							["data1", 100],
+							["data2", 150]
+						],
+						type: "gauge",
+						order: null
+					},
+					gauge: {
+						max: 500,
+						title: "Title B",
+						label: {
+							format: function(value, ratio) {
+								return value;
+							}
+						},
+						width: 80
+					}
+				}
+			}
+		]
 	},
 	LineChartOptions: {
 		HidePoints: {

spec/internals/legend-spec.js

@@ -71,7 +71,7 @@ describe("LEGEND", () => {
 		it("should be located on the right of chart", () => {
 			const x = util.parseNum(chart.$.legend.attr("transform"));
 
-			expect(x).to.be.closeTo(584, 1);
+			expect(x).to.be.closeTo(584, 3);
 		});
 	});
 

spec/shape/shape.arc-spec.js

@@ -344,7 +344,7 @@ describe("SHAPE ARC", () => {
 			expect(max.empty()).to.be.true;
 		});
 
-		it("check for fullCircle option", () => {
+		it("check for fullCircle option", done => {
 			const chart = util.generate({
 				gauge: {
 					width: 10,
@@ -354,25 +354,106 @@ describe("SHAPE ARC", () => {
 				},
 				data: {
 					columns: [
-						["data", 75]
+						["data", 10]
 					],
 					type: "gauge"
 				}
 			});
 
-			const chartArc = chart.$.main.select(`.${CLASS.chartArcs}`);
-			const min = chartArc.select(`.${CLASS.chartArcsGaugeMin}`);
-			const max = chartArc.select(`.${CLASS.chartArcsGaugeMax}`);
+			setTimeout(() => {
+				const chartArc = chart.$.main.select(`.${CLASS.chartArcs}`);
+				const min = chartArc.select(`.${CLASS.chartArcsGaugeMin}`);
+				const max = chartArc.select(`.${CLASS.chartArcsGaugeMax}`);
 
-			// check if gauge value text is centered
-			expect(+chartArc.select(`.${CLASS.gaugeValue}`).attr("dy")).to.be.above(0);
+				// check if gauge value text is centered
+				expect(+chartArc.select(`.${CLASS.gaugeValue}`).attr("dy")).to.be.above(0);
 
-			// check background height
-			expect(chartArc.select(`.${CLASS.chartArcsBackground}`).node().getBBox().height).to.be.above(400);
+				// check background height
+				expect(chartArc.select(`.${CLASS.chartArcsBackground}`).node().getBBox().height).to.be.above(400);
 
-			// with fullCircle option, only min text is showed
-			expect(min.empty()).to.be.false;
-			expect(max.empty()).to.be.true;
+				// with fullCircle option, only min text is showed
+				expect(min.empty()).to.be.false;
+				expect(max.empty()).to.be.true;
+
+				done();
+			}, 100);
+		});
+
+		it("check for stack data #1", done => {
+			const chart = util.generate({
+				size: {
+					width: 640,
+					height: 480
+				},
+				data: {
+					columns: [
+						["data1", 50, 10],
+						["data2", 200],
+						["data3", 70],
+						["data4", 50],
+						["data5", 50],
+					],
+					type: "gauge",
+					order: null
+				}
+			});
+
+			const expected = [
+				"M-304,-3.7229262694079536e-14A304,304,0,0,1,-275.25626419791655,-129.03483645824778L-165.15375851874995,-77.42090187494867A182.4,182.4,0,0,0,-182.4,-2.2337557616447722e-14Z",
+				"M-275.25626419791655,-129.03483645824778A304,304,0,0,1,98.15564305051961,-287.71769103991323L58.893385830311765,-172.63061462394796A182.4,182.4,0,0,0,-165.15375851874995,-77.42090187494867Z",
+				"M98.15564305051961,-287.71769103991323A304,304,0,0,1,226.4107435541097,-202.86491861156077L135.84644613246581,-121.71895116693646A182.4,182.4,0,0,0,58.893385830311765,-172.63061462394796Z",
+				"M226.4107435541097,-202.86491861156077A304,304,0,0,1,283.9408970546946,-108.59819049954436L170.36453823281676,-65.15891429972662A182.4,182.4,0,0,0,135.84644613246581,-121.71895116693646Z",
+				"M283.9408970546946,-108.59819049954436A304,304,0,0,1,304,0L182.4,0A182.4,182.4,0,0,0,170.36453823281676,-65.15891429972662Z"
+		  	];
+
+			setTimeout(() => {
+				chart.$.arc.selectAll(`.${CLASS.target} path`).each(function(d, i) {
+					expect(this.getAttribute("d")).to.be.equal(expected[i]);
+				});
+
+				done();
+			}, 100);
+		});
+
+		it("check for stack data #2", done => {
+			const args = {
+				size: {
+					width: 640,
+					height: 480
+				},
+				data: {
+					columns: [
+						["data1", 50],
+						["data2", 200]
+					],
+					type: "gauge",
+					order: "desc"
+				},
+				gauge: {
+					min: 50,
+					max: 550,
+					title: "TitleText"
+				}
+			};
+			const chart = util.generate(args);
+
+			const expected = [
+				"M-93.941166289984,-289.1211809537267A304,304,0,0,1,1.8614631347039768e-14,-304L1.1168778808223861e-14,-182.4A182.4,182.4,0,0,0,-56.364699773990395,-173.47270857223603Z",
+				"M-304,-3.7229262694079536e-14A304,304,0,0,1,-93.941166289984,-289.1211809537267L-56.364699773990395,-173.47270857223603A182.4,182.4,0,0,0,-182.4,-2.2337557616447722e-14Z"
+			];
+
+			setTimeout(() => {
+				const data = chart.data();
+
+				expect(chart.$.arc.select(`.${CLASS.chartArcsGaugeTitle}`).text()).to.be.equal(args.gauge.title);
+
+				chart.$.arc.selectAll(`.${CLASS.target} path`).each(function(d, i) {
+					expect(d.value).to.be.equal(data[i].values[0].value);
+					expect(this.getAttribute("d")).to.be.equal(expected[i]);
+				});
+
+				done();
+			}, 100);
 		});
 	});
 

src/config/Options.js

@@ -3048,6 +3048,7 @@ export default class Options {
 			 * @property {Number} [gauge.min=0] Set min value of the gauge.
 			 * @property {Number} [gauge.max=100] Set max value of the gauge.
 			 * @property {Number} [gauge.startingAngle=-1 * Math.PI / 2]
+			 * @property {String} [gauge.title=""] Set title of gauge chart. Use `\n` character to enter line break.
 			 * @property {String} [gauge.units] Set units of the gauge.
 			 * @property {Number} [gauge.width] Set width of gauge chart.
 			 * @example
@@ -3073,6 +3074,7 @@ export default class Options {
 			 *      },
 			 *      min: -100,
 			 *      max: 200,
+			 *      title: "Title Text",
 			 *      units: "%",
 			 *      width: 10
 			 *  }
@@ -3084,6 +3086,7 @@ export default class Options {
 			gauge_max: 100,
 			gauge_startingAngle: -1 * Math.PI / 2,
 			gauge_label_extents: undefined,
+			gauge_title: "",
 			gauge_units: undefined,
 			gauge_width: undefined,
 			gauge_expand: {},

src/config/classes.js

@@ -31,6 +31,7 @@ export default {
 	chartArcsGaugeMin: "bb-chart-arcs-gauge-min",
 	chartArcsGaugeUnit: "bb-chart-arcs-gauge-unit",
 	chartArcsTitle: "bb-chart-arcs-title",
+	chartArcsGaugeTitle: "bb-chart-arcs-gauge-title",
 	chartBar: "bb-chart-bar",
 	chartBars: "bb-chart-bars",
 	chartLine: "bb-chart-line",

src/data/data.js

@@ -323,8 +323,8 @@ extend(ChartInternal.prototype, {
 
 	/**
 	 * Get total data sum
-	 * @private
 	 * @return {Number}
+ 	 * @private
 	 */
 	getTotalDataSum() {
 		const $$ = this;
@@ -414,7 +414,7 @@ extend(ChartInternal.prototype, {
 	filterTargetsToShow(targets) {
 		const $$ = this;
 
-		return targets.filter(t => $$.isTargetToShow(t.id));
+		return (targets || $$.data.targets).filter(t => $$.isTargetToShow(t.id));
 	},
 
 	mapTargetsToUniqueXs(targets) {
@@ -497,6 +497,10 @@ extend(ChartInternal.prototype, {
 		return false;
 	},
 
+	hasMultiTargets() {
+		return this.filterTargetsToShow().length > 1;
+	},
+
 	hasNegativeValueInTargets(targets) {
 		return this.checkValueInTargets(targets, v => v < 0);
 	},
@@ -507,9 +511,9 @@ extend(ChartInternal.prototype, {
 
 	_checkOrder(type) {
 		const config = this.config;
+		const order = config.data_order;
 
-		return isString(config.data_order) &&
-			config.data_order.toLowerCase() === type;
+		return isString(order) && order.toLowerCase() === type;
 	},
 
 	isOrderDesc() {

src/internals/title.js

@@ -3,7 +3,7 @@
  * billboard.js project is licensed under the MIT license
  */
 import ChartInternal from "./ChartInternal";
-import {extend, isNumber} from "./util";
+import {extend, isNumber, setTextValue} from "./util";
 import CLASS from "../config/classes";
 
 /**
@@ -44,12 +44,7 @@ extend(ChartInternal.prototype, {
 				.style("text-anchor", getTextPos($$.config.title_position))
 				.attr("class", CLASS.title);
 
-			$$.config.title_text.split("\n").forEach((v, i) => {
-				text.append("tspan")
-					.attr("x", 0)
-					.attr("dy", `${i ? "1.5" : ".3"}em`)
-					.text(v);
-			});
+			setTextValue(text, $$.config.title_text, [0.3, 1.5]);
 		}
 	},
 

src/internals/util.js

@@ -76,6 +76,34 @@ const callFn = (fn, ...args) => {
  */
 const sanitise = str => (isString(str) ? str.replace(/</g, "&lt;").replace(/>/g, "&gt;") : str);
 
+/**
+ * Set text value. If there's multiline add nodes.
+ * @param {d3Selection} node Text node
+ * @param {String} text Text value string
+ * @param {Array} lineHeight Line height value for multilined text
+ */
+const setTextValue = (node, text, lineHeight = [-1, 1]) => {
+	if (text.indexOf("\n") === -1) {
+		node.text(text);
+	} else {
+		const diff = [node.text(), text].map(v => v.replace(/[\s\n]/g, ""));
+
+		if (diff[0] !== diff[1]) {
+			const multiline = text.split("\n");
+
+			// reset possible text
+			node.html("");
+
+			multiline.forEach((v, i) => {
+				node.append("tspan")
+					.attr("x", 0)
+					.attr("dy", `${i === 0 ? lineHeight[0] : lineHeight[1]}em`)
+					.text(v);
+			});
+		}
+	}
+};
+
 // substitution of SVGPathSeg API polyfill
 const getRectSegList = path => {
 	/*
@@ -370,6 +398,7 @@ export {
 	mergeArray,
 	notEmpty,
 	sanitise,
+	setTextValue,
 	sortValue,
 	toArray,
 	tplProcess

src/scss/billboard.scss

@@ -215,6 +215,11 @@
   font-size: 1.3em;
 }
 
+.bb-chart-arcs-gauge-title {
+  dominant-baseline: middle;
+  font-size: 2.7em;
+}
+
 .bb-chart-arcs {
   .bb-chart-arcs-background {
     fill: #e0e0e0;

src/scss/theme/graph.scss

@@ -285,6 +285,11 @@ rect.bb-circle, use.bb-circle {
     font-size: 1.3em;
 }
 
+.bb-chart-arcs-gauge-title {
+    dominant-baseline: middle;
+    font-size: 2.7em;
+}
+
 .bb-chart-arcs {
     .bb-chart-arcs-background {
         fill: #e0e0e0;

src/scss/theme/insight.scss

@@ -265,6 +265,11 @@ rect.bb-circle, use.bb-circle {
     font-size: 1.3em;
 }
 
+.bb-chart-arcs-gauge-title {
+    dominant-baseline: middle;
+    font-size: 2.7em;
+}
+
 .bb-chart-arcs {
     .bb-chart-arcs-background {
         fill: #e0e0e0;