Implement legend.align: 'start'/'center'/'end'

docs/configuration/legend.md

@@ -9,6 +9,7 @@ The legend configuration is passed into the `options.legend` namespace. The glob
 | ---- | ---- | ------- | -----------
 | `display` | `boolean` | `true` | Is the legend shown?
 | `position` | `string` | `'top'` | Position of the legend. [more...](#position)
+| `align` | `string` | `'center'` | Alignment of the legend. [more...](#align)
 | `fullWidth` | `boolean` | `true` | Marks that this box should take the full width of the canvas (pushing down other boxes). This is unlikely to need to be changed in day-to-day use.
 | `onClick` | `function` | | A callback that is called when a click event is registered on a label item.
 | `onHover` | `function` | | A callback that is called when a 'mousemove' event is registered on top of a label item.
@@ -23,6 +24,14 @@ Position of the legend. Options are:
 * `'bottom'`
 * `'right'`
 
+## Align
+Alignment of the legend. Options are:
+* `'start'` (default for left/right positioned legends)
+* `'center'` (default for top/bottom positioned legends)
+* `'end'`
+
+Defaults to `'center'` for unrecognized values.
+
 ## Legend Label Configuration
 
 The legend label configuration is nested below the legend configuration using the `labels` key.

src/plugins/plugin.legend.js

@@ -102,18 +102,23 @@ function getBoxWidth(labelOpts, fontSize) {
 var Legend = Element.extend({
 
 	initialize: function(config) {
-		helpers.extend(this, config);
+		var me = this;
+		helpers.extend(me, config);
 
+		if (me.options && !me.align) {
+			// to maintain backward compatibility with existing default
+			me.options.align = me.isHorizontal() ? 'center' : 'start';
+		}
 		// Contains hit boxes for each dataset (in dataset order)
-		this.legendHitBoxes = [];
+		me.legendHitBoxes = [];
 
 		/**
  		 * @private
  		 */
-		this._hoveredItem = null;
+		me._hoveredItem = null;
 
 		// Are we in doughnut mode which has a different data type
-		this.doughnutMode = false;
+		me.doughnutMode = false;
 	},
 
 	// These methods are ordered by lifecycle. Utilities then follow.
@@ -255,7 +260,7 @@ var Legend = Element.extend({
 
 					if (i === 0 || lineWidths[lineWidths.length - 1] + width + labelOpts.padding > minSize.width) {
 						totalHeight += fontSize + labelOpts.padding;
-						lineWidths[lineWidths.length - (i > 0 ? 0 : 1)] = labelOpts.padding;
+						lineWidths[lineWidths.length - (i > 0 ? 0 : 1)] = 0;
 					}
 
 					// Store the hitbox width and height here. Final position will be updated in `draw`
@@ -274,6 +279,7 @@ var Legend = Element.extend({
 			} else {
 				var vPadding = labelOpts.padding;
 				var columnWidths = me.columnWidths = [];
+				var columnHeights = me.columnHeights = [];
 				var totalWidth = labelOpts.padding;
 				var currentColWidth = 0;
 				var currentColHeight = 0;
@@ -287,7 +293,7 @@ var Legend = Element.extend({
 					if (i > 0 && currentColHeight + itemHeight > minSize.height - vPadding) {
 						totalWidth += currentColWidth + labelOpts.padding;
 						columnWidths.push(currentColWidth); // previous column width
-
+						columnHeights.push(currentColHeight);
 						currentColWidth = 0;
 						currentColHeight = 0;
 					}
@@ -307,6 +313,7 @@ var Legend = Element.extend({
 
 				totalWidth += currentColWidth;
 				columnWidths.push(currentColWidth);
+				columnHeights.push(currentColHeight);
 				minSize.width += totalWidth;
 			}
 		}
@@ -329,6 +336,8 @@ var Legend = Element.extend({
 		var globalDefaults = defaults.global;
 		var defaultColor = globalDefaults.defaultColor;
 		var lineDefault = globalDefaults.elements.line;
+		var legendHeight = me.height;
+		var columnHeights = me.columnHeights;
 		var legendWidth = me.width;
 		var lineWidths = me.lineWidths;
 
@@ -408,19 +417,30 @@ var Legend = Element.extend({
 				}
 			};
 
+			var alignmentOffset = function(dimension, blockSize) {
+				if (opts.align === 'start') {
+					return labelOpts.padding;
+				} else if (opts.align === 'end') {
+					return dimension - blockSize;
+				}
+				// default to center
+				return (dimension - blockSize + labelOpts.padding) / 2;
+			};
+
 			// Horizontal
 			var isHorizontal = me.isHorizontal();
+			var line = 0;
 			if (isHorizontal) {
 				cursor = {
-					x: me.left + ((legendWidth - lineWidths[0]) / 2) + labelOpts.padding,
+					x: me.left + alignmentOffset(legendWidth, lineWidths[line]),
 					y: me.top + labelOpts.padding,
-					line: 0
+					line: line
 				};
 			} else {
 				cursor = {
 					x: me.left + labelOpts.padding,
-					y: me.top + labelOpts.padding,
-					line: 0
+					y: me.top + alignmentOffset(legendHeight, columnHeights[line]),
+					line: line
 				};
 			}
 
@@ -438,12 +458,12 @@ var Legend = Element.extend({
 					if (i > 0 && x + width + labelOpts.padding > me.left + me.minSize.width) {
 						y = cursor.y += itemHeight;
 						cursor.line++;
-						x = cursor.x = me.left + ((legendWidth - lineWidths[cursor.line]) / 2) + labelOpts.padding;
+						x = cursor.x = me.left + alignmentOffset(legendWidth, lineWidths[cursor.line]);
 					}
 				} else if (i > 0 && y + itemHeight > me.top + me.minSize.height) {
 					x = cursor.x = x + me.columnWidths[cursor.line] + labelOpts.padding;
-					y = cursor.y = me.top + labelOpts.padding;
 					cursor.line++;
+					y = cursor.y = me.top + alignmentOffset(legendHeight, columnHeights[cursor.line]);
 				}
 
 				drawLegendBox(x, y, legendItem);
@@ -459,7 +479,6 @@ var Legend = Element.extend({
 				} else {
 					cursor.y += itemHeight;
 				}
-
 			});
 		}
 	},

test/fixtures/plugin.legend/legend-doughnut-left-center-mulitiline.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""],
+			"datasets": [{
+				"data": [10, 20, 30, 40, 50, 60, 70, 10, 20, 30, 40, 50, 60, 70, 10, 20, 30]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "left",
+				"align": "center"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-left-center-single.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": [""],
+			"datasets": [{
+				"data": [10]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "left",
+				"align": "center"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-left-default-start.json

@@ -0,0 +1,22 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": ["", "", "", "", "", ""],
+			"datasets": [{
+				"data": [10, 20, 30, 40, 50]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "left"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-left-end-mulitiline.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""],
+			"datasets": [{
+				"data": [10, 20, 30, 40, 50, 60, 70, 10, 20, 30, 40, 50, 60, 70, 10, 20, 30]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "left",
+				"align": "end"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-left-start-mulitiline.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""],
+			"datasets": [{
+				"data": [10, 20, 30, 40, 50, 60, 70, 10, 20, 30, 40, 50, 60, 70, 10, 20, 30]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "left",
+				"align": "start"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-top-center-mulitiline.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""],
+			"datasets": [{
+				"data": [10, 20, 30, 40, 50, 60, 70, 10, 20, 30, 40, 50, 60, 70, 10, 20, 30, 20, 10]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "top",
+				"align": "center"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-top-center-single.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": [""],
+			"datasets": [{
+				"data": [10]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "top",
+				"align": "center"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-top-end-mulitiline.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""],
+			"datasets": [{
+				"data": [10, 20, 30, 40, 50, 60, 70, 10, 20, 30, 40, 50, 60, 70, 10]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "top",
+				"align": "end"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}

test/fixtures/plugin.legend/legend-doughnut-top-start-mulitiline.json

@@ -0,0 +1,23 @@
+{
+	"config": {
+		"type": "doughnut",
+		"data": {
+			"labels": ["", "", "", "", "", "", "", "", "", "", "", "", "", "", "", "", ""],
+			"datasets": [{
+				"data": [10, 20, 30, 40, 50, 60, 70, 10, 20, 30, 40, 50, 60, 70, 10]
+			}]
+		},
+		"options": {
+			"legend": {
+				"position": "top",
+				"align": "start"
+			}
+		}
+	},
+	"options": {
+		"canvas": {
+			"height": 256,
+			"width": 512
+		}
+	}
+}