[Bars] Add possibility to display totals for bars

Contributes to plotly#85

Author: wilhelmhb

src/traces/bar/layout_attributes.js

@@ -63,5 +63,17 @@ module.exports = {
             'Sets the gap (in plot fraction) between bars of',
             'the same location coordinate.'
         ].join(' ')
-    }
+    },
+    displaytotal: {
+        valType: 'boolean',
+        dflt: false,
+        role: 'style',
+        description: 'Display the total value of each bar.'
+    },
+    totaltemplate: {
+        valType: 'string',
+        dflt: '%{total}',
+        role: 'style',
+        description: 'Template to display the total value of each bar.'
+    },
 };

src/traces/bar/layout_defaults.js

@@ -55,4 +55,6 @@ module.exports = function(layoutIn, layoutOut, fullData) {
 
     coerce('bargap', (shouldBeGapless && !gappedAnyway) ? 0 : 0.2);
     coerce('bargroupgap');
+    coerce('displaytotal');
+    coerce('totaltemplate');
 };

src/traces/bar/plot.js

@@ -251,6 +251,9 @@ function plot(gd, plotinfo, cdModule, traceLayer, opts, makeOnCompleteCallback)
             }
 
             appendBarText(gd, plotinfo, bar, cd, i, x0, x1, y0, y1, opts, makeOnCompleteCallback);
+            if(fullLayout.displaytotal) {
+                appendBarTotal(gd, plotinfo, bar, cd, i, x0, x1, y0, y1, opts, makeOnCompleteCallback);
+            }
 
             if(plotinfo.layerClipId) {
                 Drawing.hideOutsideRangePoint(di, bar.select('text'), xa, ya, trace.xcalendar, trace.ycalendar);
@@ -275,7 +278,7 @@ function appendBarText(gd, plotinfo, bar, cd, i, x0, x1, y0, y1, opts, makeOnCom
     var textPosition;
 
     function appendTextNode(bar, text, font) {
-        var textSelection = Lib.ensureSingle(bar, 'text')
+        var textSelection = Lib.ensureSingle(bar, 'text', 'bartext-' + textPosition)
             .text(text)
             .attr({
                 'class': 'bartext bartext-' + textPosition,
@@ -443,6 +446,48 @@ function appendBarText(gd, plotinfo, bar, cd, i, x0, x1, y0, y1, opts, makeOnCom
         .attr('transform', Lib.getTextTransform(transform));
 }
 
+// total for stacked bars
+function appendBarTotal(gd, plotinfo, bar, cd, i, x0, x1, y0, y1, opts, makeOnCompleteCallback) {
+    var fullLayout = gd._fullLayout;
+    // get trace attributes
+    var trace = cd[0].trace;
+    var isHorizontal = (trace.orientation === 'h');
+    var inStackOrRelativeMode =
+        opts.mode === 'stack' ||
+        opts.mode === 'relative';
+    var calcBar = cd[i];
+    var isOutmostBar = !inStackOrRelativeMode || calcBar._outmost;
+
+    if(isOutmostBar) {
+        var layoutFont = fullLayout.font;
+        var font = style.getOutsideTextFont(trace, i, layoutFont);
+        var totalTemplate = fullLayout.totaltemplate;
+        var obj = {total: isHorizontal ? calcBar.x : calcBar.y};
+        var totalText = Lib.texttemplateString(totalTemplate, obj, fullLayout._d2locale, {}, obj, trace._meta || {});
+        var totalSelection = Lib.ensureSingle(bar, 'text', 'bartext-outside')
+            .text(totalText)
+            .attr({
+                'class': 'bartext bartext-outside',
+                'text-anchor': 'middle',
+                // prohibit tex interpretation until we can handle
+                // tex and regular text together
+                'data-notex': 1
+            })
+            .call(Drawing.font, font)
+            .call(svgTextUtils.convertToTspans, gd);
+
+        var textBB = Drawing.bBox(totalSelection.node());
+        var transform = toMoveOutsideBar(x0, x1, y0, y1, textBB, {
+            isHorizontal: isHorizontal,
+            constrained: false,
+            angle: trace.textangle
+        });
+
+        transition(totalSelection, fullLayout, opts, makeOnCompleteCallback)
+            .attr('transform', Lib.getTextTransform(transform));
+    }
+}
+
 function getRotateFromAngle(angle) {
     return (angle === 'auto') ? 0 : angle;
 }