From 60b0936c303f2442578c2f481c829b3093df5009 Mon Sep 17 00:00:00 2001
From: Shumpei Shiina <s417.lama@gmail.com>
Date: Wed, 14 Oct 2020 23:09:41 +0900
Subject: [PATCH 1/2] add legend.itemwidth option to set the width of the
 symbol area of legends

---
 src/components/legend/attributes.js           |   7 +++
 src/components/legend/constants.js            |   2 -
 src/components/legend/defaults.js             |   1 +
 src/components/legend/draw.js                 |   8 ++--
 src/components/legend/style.js                |  26 +++++-----
 .../baselines/legend_itemwidth_dashline.png   | Bin 0 -> 27667 bytes
 .../mocks/legend_itemwidth_dashline.json      |  45 ++++++++++++++++++
 test/jasmine/tests/mock_test.js               |   2 +
 8 files changed, 75 insertions(+), 16 deletions(-)
 create mode 100644 test/image/baselines/legend_itemwidth_dashline.png
 create mode 100644 test/image/mocks/legend_itemwidth_dashline.json

diff --git a/src/components/legend/attributes.js b/src/components/legend/attributes.js
index 8e2456ef157..d478d39c5b3 100644
--- a/src/components/legend/attributes.js
+++ b/src/components/legend/attributes.js
@@ -92,6 +92,13 @@ module.exports = {
             'or remain *constant* independent of the symbol size on the graph.'
         ].join(' ')
     },
+    itemwidth: {
+        valType: 'number',
+        dflt: 30,
+        role: 'style',
+        editType: 'legend',
+        description: 'Sets the width (in px) of the legend item symbols (the part other than the text).',
+    },
 
     itemclick: {
         valType: 'enumerated',
diff --git a/src/components/legend/constants.js b/src/components/legend/constants.js
index 67a0468c3d2..8a213bf6413 100644
--- a/src/components/legend/constants.js
+++ b/src/components/legend/constants.js
@@ -17,8 +17,6 @@ module.exports = {
 
     // number of px between legend title and (left) side of legend (always in x direction and from inner border)
     titlePad: 2,
-    // number of px between legend symbol and legend text (always in x direction)
-    textGap: 40,
     // number of px between each legend item (x and/or y direction)
     itemGap: 5
 };
diff --git a/src/components/legend/defaults.js b/src/components/legend/defaults.js
index 9077a1e7890..06e2bce6d12 100644
--- a/src/components/legend/defaults.js
+++ b/src/components/legend/defaults.js
@@ -113,6 +113,7 @@ module.exports = function legendDefaults(layoutIn, layoutOut, fullData) {
     if(helpers.isGrouped(layoutOut.legend)) coerce('tracegroupgap');
 
     coerce('itemsizing');
+    coerce('itemwidth');
 
     coerce('itemclick');
     coerce('itemdoubleclick');
diff --git a/src/components/legend/draw.js b/src/components/legend/draw.js
index 945067b5a40..4f79e30c5b9 100644
--- a/src/components/legend/draw.js
+++ b/src/components/legend/draw.js
@@ -412,7 +412,8 @@ function drawTexts(g, gd, opts) {
         .call(Drawing.font, opts.font)
         .text(isEditable ? ensureLength(name, maxNameLength) : name);
 
-    svgTextUtils.positionText(textEl, constants.textGap, 0);
+    var textGap = opts.itemwidth + constants.itemGap * 2;
+    svgTextUtils.positionText(textEl, textGap, 0);
 
     if(isEditable) {
         textEl.call(svgTextUtils.makeEditable, {gd: gd, text: name})
@@ -539,7 +540,8 @@ function computeTextDimensions(g, gd, opts) {
         // to avoid getBoundingClientRect
         var textY = lineHeight * ((textLines - 1) / 2 - 0.3);
         if(legendItem) {
-            svgTextUtils.positionText(textEl, constants.textGap, -textY);
+            var textGap = opts.itemwidth + constants.itemGap * 2;
+            svgTextUtils.positionText(textEl, textGap, -textY);
         } else { // case of title
             svgTextUtils.positionText(textEl, constants.titlePad + bw, lineHeight + bw);
         }
@@ -592,8 +594,8 @@ function computeLegendDimensions(gd, groups, traces, opts) {
 
     var bw = opts.borderwidth;
     var bw2 = 2 * bw;
-    var textGap = constants.textGap;
     var itemGap = constants.itemGap;
+    var textGap = opts.itemwidth + itemGap * 2;
     var endPad = 2 * (bw + itemGap);
 
     var yanchor = getYanchor(opts);
diff --git a/src/components/legend/style.js b/src/components/legend/style.js
index b7b9bec7618..5cf8e451092 100644
--- a/src/components/legend/style.js
+++ b/src/components/legend/style.js
@@ -20,6 +20,8 @@ var subTypes = require('../../traces/scatter/subtypes');
 var stylePie = require('../../traces/pie/style_one');
 var pieCastOption = require('../../traces/pie/helpers').castOption;
 
+var constants = require('./constants');
+
 var CST_MARKER_SIZE = 12;
 var CST_LINE_WIDTH = 5;
 var CST_MARKER_LINE_WIDTH = 2;
@@ -30,6 +32,8 @@ module.exports = function style(s, gd, legend) {
     var fullLayout = gd._fullLayout;
     if(!legend) legend = fullLayout.legend;
     var constantItemSizing = legend.itemsizing === 'constant';
+    var itemWidth = legend.itemwidth;
+    var centerPos = (itemWidth + constants.itemGap * 2) / 2;
 
     var boundLineWidth = function(mlw, cont, max, cst) {
         var v;
@@ -161,7 +165,7 @@ module.exports = function style(s, gd, legend) {
             .data(showFill || showGradientFill ? [d] : []);
         fill.enter().append('path').classed('js-fill', true);
         fill.exit().remove();
-        fill.attr('d', pathStart + 'h30v6h-30z')
+        fill.attr('d', pathStart + 'h' + itemWidth + 'v6h-' + itemWidth + 'z')
             .call(showFill ? Drawing.fillGroupStyle : fillGradient);
 
         if(showLine || showGradientLine) {
@@ -181,7 +185,7 @@ module.exports = function style(s, gd, legend) {
         // though there *is* no vertical variation in this case.
         // so add an invisibly small angle to the line
         // This issue (and workaround) exist across (Mac) Chrome, FF, and Safari
-        line.attr('d', pathStart + (showGradientLine ? 'l30,0.0001' : 'h30'))
+        line.attr('d', pathStart + (showGradientLine ? 'l' + itemWidth + ',0.0001' : 'h' + itemWidth))
             .call(showLine ? Drawing.lineGroupStyle : lineGradient);
     }
 
@@ -271,7 +275,7 @@ module.exports = function style(s, gd, legend) {
         // make sure marker is on the bottom, in case it enters after text
         pts.enter().insert('path', ':first-child')
             .classed('scatterpts', true)
-            .attr('transform', 'translate(20,0)');
+            .attr('transform', 'translate(' + centerPos + ',0)');
         pts.exit().remove();
         pts.call(Drawing.pointStyle, tMod, gd);
 
@@ -283,7 +287,7 @@ module.exports = function style(s, gd, legend) {
             .data(showText ? dMod : []);
         txt.enter()
             .append('g').classed('pointtext', true)
-                .append('text').attr('transform', 'translate(20,0)');
+                .append('text').attr('transform', 'translate(' + centerPos + ',0)');
         txt.exit().remove();
         txt.selectAll('text').call(Drawing.textPointStyle, tMod, gd);
     }
@@ -311,7 +315,7 @@ module.exports = function style(s, gd, legend) {
             .selectAll('path.legendwaterfall')
             .data(ptsData);
         pts.enter().append('path').classed('legendwaterfall', true)
-            .attr('transform', 'translate(20,0)')
+            .attr('transform', 'translate(' + centerPos + ',0)')
             .style('stroke-miterlimit', 1);
         pts.exit().remove();
 
@@ -351,7 +355,7 @@ module.exports = function style(s, gd, legend) {
             .data(isVisible ? [d] : []);
         barpath.enter().append('path').classed('legend' + desiredType, true)
             .attr('d', 'M6,6H-6V-6H6Z')
-            .attr('transform', 'translate(20,0)');
+            .attr('transform', 'translate(' + centerPos + ',0)');
         barpath.exit().remove();
 
         barpath.each(function(d) {
@@ -375,7 +379,7 @@ module.exports = function style(s, gd, legend) {
         pts.enter().append('path').classed('legendbox', true)
             // if we want the median bar, prepend M6,0H-6
             .attr('d', 'M6,6H-6V-6H6Z')
-            .attr('transform', 'translate(20,0)');
+            .attr('transform', 'translate(' + centerPos + ',0)');
         pts.exit().remove();
 
         pts.each(function() {
@@ -415,7 +419,7 @@ module.exports = function style(s, gd, legend) {
                 if(i) return 'M-15,0H-8M-8,6V-6H8Z'; // increasing
                 return 'M15,0H8M8,-6V6H-8Z'; // decreasing
             })
-            .attr('transform', 'translate(20,0)')
+            .attr('transform', 'translate(' + centerPos + ',0)')
             .style('stroke-miterlimit', 1);
         pts.exit().remove();
 
@@ -442,7 +446,7 @@ module.exports = function style(s, gd, legend) {
                 if(i) return 'M-15,0H0M-8,-6V0'; // increasing
                 return 'M15,0H0M8,6V0'; // decreasing
             })
-            .attr('transform', 'translate(20,0)')
+            .attr('transform', 'translate(' + centerPos + ',0)')
             .style('stroke-miterlimit', 1);
         pts.exit().remove();
 
@@ -478,7 +482,7 @@ module.exports = function style(s, gd, legend) {
             .data(isVisible ? [d] : []);
         pts.enter().append('path').classed('legend' + desiredType, true)
             .attr('d', 'M6,6H-6V-6H6Z')
-            .attr('transform', 'translate(20,0)');
+            .attr('transform', 'translate(' + centerPos + ',0)');
         pts.exit().remove();
 
         if(pts.size()) {
@@ -576,7 +580,7 @@ module.exports = function style(s, gd, legend) {
             .selectAll('path.legend3dandfriends')
             .data(ptsData);
         pts.enter().append('path').classed('legend3dandfriends', true)
-            .attr('transform', 'translate(20,0)')
+            .attr('transform', 'translate(' + centerPos + ',0)')
             .style('stroke-miterlimit', 1);
         pts.exit().remove();
 
diff --git a/test/image/baselines/legend_itemwidth_dashline.png b/test/image/baselines/legend_itemwidth_dashline.png
new file mode 100644
index 0000000000000000000000000000000000000000..016e4aaa4d2d4dfb940b8ac9153f735af9e08b20
GIT binary patch
literal 27667
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
X*xYTTL>FH6wa!S-OqZs8Cis5<z*%r^

literal 0
HcmV?d00001

diff --git a/test/image/mocks/legend_itemwidth_dashline.json b/test/image/mocks/legend_itemwidth_dashline.json
new file mode 100644
index 00000000000..000cd459e15
--- /dev/null
+++ b/test/image/mocks/legend_itemwidth_dashline.json
@@ -0,0 +1,45 @@
+{
+  "data": [
+    {
+      "x": [
+        2,
+        3,
+        4,
+        5
+      ],
+      "y": [
+        16,
+        5,
+        11,
+        9
+      ],
+      "line": {
+        "dash": "dashdot"
+      },
+      "type": "scatter"
+    },
+    {
+      "x": [
+        1,
+        2,
+        3,
+        4
+      ],
+      "y": [
+        12,
+        9,
+        15,
+        12
+      ],
+      "line": {
+        "dash": "dash"
+      },
+      "type": "scatter"
+    }
+  ],
+  "layout": {
+    "legend": {
+      "itemwidth": 60
+    }
+  }
+}
diff --git a/test/jasmine/tests/mock_test.js b/test/jasmine/tests/mock_test.js
index 86825fc7e0d..a3e7cd1d6b6 100644
--- a/test/jasmine/tests/mock_test.js
+++ b/test/jasmine/tests/mock_test.js
@@ -669,6 +669,7 @@ var list = [
     'legend_horizontal_one_row',
     'legend_horizontal_wrap-alll-lines',
     'legend_inside',
+    'legend_itemwidth_dashline',
     'legend_labels',
     'legend_large_margin',
     'legend_margin-autoexpand-false',
@@ -1733,6 +1734,7 @@ figs['legend_horizontal_groups'] = require('@mocks/legend_horizontal_groups');
 figs['legend_horizontal_one_row'] = require('@mocks/legend_horizontal_one_row');
 figs['legend_horizontal_wrap-alll-lines'] = require('@mocks/legend_horizontal_wrap-alll-lines');
 figs['legend_inside'] = require('@mocks/legend_inside');
+figs['legend_itemwidth_dashline'] = require('@mocks/legend_itemwidth_dashline');
 figs['legend_labels'] = require('@mocks/legend_labels');
 figs['legend_large_margin'] = require('@mocks/legend_large_margin');
 figs['legend_margin-autoexpand-false'] = require('@mocks/legend_margin-autoexpand-false');

From 1977f12710ed89576b53fb97a911c4f4fd23829d Mon Sep 17 00:00:00 2001
From: Shumpei Shiina <s417.lama@gmail.com>
Date: Wed, 4 Nov 2020 09:17:18 +0900
Subject: [PATCH 2/2] Fix based on review comments

---
 src/components/legend/attributes.js |  3 ++-
 src/components/legend/style.js      | 19 ++++++++++---------
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/src/components/legend/attributes.js b/src/components/legend/attributes.js
index d478d39c5b3..07e4785fbe9 100644
--- a/src/components/legend/attributes.js
+++ b/src/components/legend/attributes.js
@@ -94,10 +94,11 @@ module.exports = {
     },
     itemwidth: {
         valType: 'number',
+        min: 30,
         dflt: 30,
         role: 'style',
         editType: 'legend',
-        description: 'Sets the width (in px) of the legend item symbols (the part other than the text).',
+        description: 'Sets the width (in px) of the legend item symbols (the part other than the title.text).',
     },
 
     itemclick: {
diff --git a/src/components/legend/style.js b/src/components/legend/style.js
index 5cf8e451092..e34143cafe9 100644
--- a/src/components/legend/style.js
+++ b/src/components/legend/style.js
@@ -34,6 +34,7 @@ module.exports = function style(s, gd, legend) {
     var constantItemSizing = legend.itemsizing === 'constant';
     var itemWidth = legend.itemwidth;
     var centerPos = (itemWidth + constants.itemGap * 2) / 2;
+    var centerTransform = 'translate(' + centerPos + ',0)';
 
     var boundLineWidth = function(mlw, cont, max, cst) {
         var v;
@@ -275,7 +276,7 @@ module.exports = function style(s, gd, legend) {
         // make sure marker is on the bottom, in case it enters after text
         pts.enter().insert('path', ':first-child')
             .classed('scatterpts', true)
-            .attr('transform', 'translate(' + centerPos + ',0)');
+            .attr('transform', centerTransform);
         pts.exit().remove();
         pts.call(Drawing.pointStyle, tMod, gd);
 
@@ -287,7 +288,7 @@ module.exports = function style(s, gd, legend) {
             .data(showText ? dMod : []);
         txt.enter()
             .append('g').classed('pointtext', true)
-                .append('text').attr('transform', 'translate(' + centerPos + ',0)');
+                .append('text').attr('transform', centerTransform);
         txt.exit().remove();
         txt.selectAll('text').call(Drawing.textPointStyle, tMod, gd);
     }
@@ -315,7 +316,7 @@ module.exports = function style(s, gd, legend) {
             .selectAll('path.legendwaterfall')
             .data(ptsData);
         pts.enter().append('path').classed('legendwaterfall', true)
-            .attr('transform', 'translate(' + centerPos + ',0)')
+            .attr('transform', centerTransform)
             .style('stroke-miterlimit', 1);
         pts.exit().remove();
 
@@ -355,7 +356,7 @@ module.exports = function style(s, gd, legend) {
             .data(isVisible ? [d] : []);
         barpath.enter().append('path').classed('legend' + desiredType, true)
             .attr('d', 'M6,6H-6V-6H6Z')
-            .attr('transform', 'translate(' + centerPos + ',0)');
+            .attr('transform', centerTransform);
         barpath.exit().remove();
 
         barpath.each(function(d) {
@@ -379,7 +380,7 @@ module.exports = function style(s, gd, legend) {
         pts.enter().append('path').classed('legendbox', true)
             // if we want the median bar, prepend M6,0H-6
             .attr('d', 'M6,6H-6V-6H6Z')
-            .attr('transform', 'translate(' + centerPos + ',0)');
+            .attr('transform', centerTransform);
         pts.exit().remove();
 
         pts.each(function() {
@@ -419,7 +420,7 @@ module.exports = function style(s, gd, legend) {
                 if(i) return 'M-15,0H-8M-8,6V-6H8Z'; // increasing
                 return 'M15,0H8M8,-6V6H-8Z'; // decreasing
             })
-            .attr('transform', 'translate(' + centerPos + ',0)')
+            .attr('transform', centerTransform)
             .style('stroke-miterlimit', 1);
         pts.exit().remove();
 
@@ -446,7 +447,7 @@ module.exports = function style(s, gd, legend) {
                 if(i) return 'M-15,0H0M-8,-6V0'; // increasing
                 return 'M15,0H0M8,6V0'; // decreasing
             })
-            .attr('transform', 'translate(' + centerPos + ',0)')
+            .attr('transform', centerTransform)
             .style('stroke-miterlimit', 1);
         pts.exit().remove();
 
@@ -482,7 +483,7 @@ module.exports = function style(s, gd, legend) {
             .data(isVisible ? [d] : []);
         pts.enter().append('path').classed('legend' + desiredType, true)
             .attr('d', 'M6,6H-6V-6H6Z')
-            .attr('transform', 'translate(' + centerPos + ',0)');
+            .attr('transform', centerTransform);
         pts.exit().remove();
 
         if(pts.size()) {
@@ -580,7 +581,7 @@ module.exports = function style(s, gd, legend) {
             .selectAll('path.legend3dandfriends')
             .data(ptsData);
         pts.enter().append('path').classed('legend3dandfriends', true)
-            .attr('transform', 'translate(' + centerPos + ',0)')
+            .attr('transform', centerTransform)
             .style('stroke-miterlimit', 1);
         pts.exit().remove();