Implement legend entries for surface (and others like heatmap, contour) traces

[skolb2]

Hi,
I'm using plotly.js 1.37.1 in an Angular 5 application and the showlegend attribute seems to be broken for 3D Ribbon and 3D Surface charts.

Changing the attribute and calling relayout has no effect on the chart.

The problem also appears to happen in any of the example charts in the documentation (for example this one from the documentation: Ribbon Plot example or this one: 3D Surface Plot example) Opening them in Codepen and changing the showlegend attribute has no effect on the legend.

[alexcjohnson]

Surface plots (and these ribbon plots are just specialized surface plots) are like heatmap and contour maps, they generally get colorscales (controlled by showscale) rather than legend entries. We've never implemented legend items for any of these traces, so they're not broken, but you could make a case for us to add them. I guess in the special case of multiple single-color surfaces a legend entry could be useful to label them, and even colorscaled items could benefit from a legend entry to allow you to toggle them on and off.

[ChristofferHS]

even colorscaled items could benefit from a legend entry to allow you to toggle them on and off

It would also enable the user to group such traces, such that their visibility can be toggled on and off along with associated traces, even if they don't show up in the legend themselves.

While the filling option for scatter3d is missing (#2352), surfaces are a viable substitute, but one would then need to use events to toggle their visibility when the visibility of their associated lines are toggled via the legend.

[etpinard]

but one would then need to use events to toggle their visibility when the visibility of their associated lines are toggled via the legend.

That could be done using (our recently added #2581) a custom legend handler.

[connorferster]

I also request this feature to be added.

After hours of searching, I finally found a community post that explicitly stated that Mesh3d and Surface traces do not support legends: how to name axis and show legend in mesh3d. However, this is not described anywhere in the documentation for either Mesh3d or Surface (they both show that they support the showlegend property).

The use case is as described above regarding having multiple surfaces or mesh3d traces with a constant color such as when you want to use a "fill" on a scatter3d plot.

[alexcjohnson]

they both show that they support the showlegend property

Oof, sorry for the confusion! related: #3058

[antoinerg]

@alexcjohnson In the meantime, should I prune the legend-related attributes for traces that don't support them?

[marcotama]

I would also love to have legend entries for Surfaces.

I am using Surfaces to show an image in a 3D plot (via dark wizardry), and I have several other traces in the plot. I would love to be able to only see the image and one of the traces, but if I double click on the legend entry of the trace I want to see, all other traces are disabled, including my image, and there is no way to turn it back on other than double click on the legend entry again, but that also re-enables all the other traces. Not sure if this makes as much sense to you as it does in my head!

[giiyms]

Is there any hack or custom legend overlay that can be done until a proper implementation is found?