Clarify that pie legend and showlegend can only be arrays if values is provided.

my-tien · my-tien · commit 3e5e53fab255 · 2025-11-26T13:34:17.000+01:00
diff --git a/src/traces/pie/attributes.js b/src/traces/pie/attributes.js
@@ -181,10 +181,22 @@ module.exports = {
         description: ['Determines whether outside text labels can push the margins.'].join(' ')
     },
     showlegend: extendFlat({}, baseAttrs.showlegend, {
-        arrayOk: true
+        arrayOk: true,
+        description: [
+            'Determines whether or not items corresponding to the pie slices are shown in the',
+            'legend. Can be an array if `values` is set. In that case, each entry specifies',
+            'appearance in the legend for one slice.'
+        ].join(' ')
     }),
     legend: extendFlat({}, baseAttrs.legend, {
-        arrayOk: true
+        arrayOk: true,
+        description: [
+            'Sets the reference to a legend to show the pie slices in. Can be an array if `values`',
+            'is set. In that case, each entry specifies the legend reference for one slice.',
+            'References to these legends are *legend*, *legend2*, *legend3*, etc.',
+            'Settings for these legends are set in the layout, under',
+            '`layout.legend`, `layout.legend2`, etc.'
+        ].join(' ')
     }),
     title: {
         text: {
diff --git a/test/plot-schema.json b/test/plot-schema.json
@@ -56615,7 +56615,7 @@
         },
         "legend": {
           "arrayOk": true,
-          "description": "Sets the reference to a legend to show this trace in. References to these legends are *legend*, *legend2*, *legend3*, etc. Settings for these legends are set in the layout, under `layout.legend`, `layout.legend2`, etc.",
+          "description": "Sets the reference to a legend to show the pie slices in. Can be an array if `values` is set. In that case, each entry specifies the legend reference for one slice. References to these legends are *legend*, *legend2*, *legend3*, etc. Settings for these legends are set in the layout, under `layout.legend`, `layout.legend2`, etc.",
           "dflt": "legend",
           "editType": "style",
           "valType": "subplotid"
@@ -57084,7 +57084,7 @@
         },
         "showlegend": {
           "arrayOk": true,
-          "description": "Determines whether or not an item corresponding to this trace is shown in the legend.",
+          "description": "Determines whether or not items corresponding to the pie slices are shown in the legend. Can be an array if `values` is set. In that case, each entry specifies appearance in the legend for one slice.",
           "dflt": true,
           "editType": "style",
           "valType": "boolean"
