Merge pull request #5527 from plotly/update-plotlyjs-3.4.0

upgrade plotly.js to v3.4.0

Author: emilykl

CHANGELOG.md

@@ -4,6 +4,13 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## Unreleased
 
+### Updated
+- Update plotly.js from version 3.3.1 to version 3.4.0. See the plotly.js [release notes](https://github.com/plotly/plotly.js/releases/tag/v3.4.0) for more information. [[#5527](https://github.com/plotly/plotly.py/pull/5527)]. Notable changes include:
+  - Add support for clicking legend titles to toggle visibility of all traces in legend [[#7698](https://github.com/plotly/plotly.js/pull/7698)]
+  - Add support for shapes to reference multiple axes [[#7666](https://github.com/plotly/plotly.js/pull/7666)]
+  - Add support for dashed marker lines in scatter plots [[#7673](https://github.com/plotly/plotly.js/pull/7673)]
+  - Increase axis autorange when bar charts have outside text labels, to avoid labels being clipped [[#7675](https://github.com/plotly/plotly.js/pull/7675)]
+
 ## [6.5.2] - 2026-01-14
 
 ### Fixed

codegen/resources/plot-schema.json

@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "lodash-es": "^4.17.21",
-    "plotly.js": "3.3.1",
+    "plotly.js": "3.4.0",
     "@lumino/widgets": "~2.4.0"
   },
   "devDependencies": {

js/lib/mimeExtension.js

@@ -25072,13 +25072,15 @@ def add_shape(
         x1shift=None,
         xanchor=None,
         xref=None,
+        xrefsrc=None,
         xsizemode=None,
         y0=None,
         y0shift=None,
         y1=None,
         y1shift=None,
         yanchor=None,
         yref=None,
+        yrefsrc=None,
         ysizemode=None,
         row=None,
         col=None,
@@ -25243,7 +25245,15 @@ def add_shape(
             domain of that axis: e.g., *x2 domain* refers to the
             domain of the second x  axis and a x position of 0.5
             refers to the point between the left and the right of
-            the domain of the second x axis.
+            the domain of the second x axis. If an array of axis
+            IDs is provided, each `x` value will refer to the
+            corresponding axis, e.g., ['x', 'x2'] for a rectangle,
+            line, or circle means `x0` uses the `x` axis and `x1`
+            uses the `x2` axis. Path shapes using an array should
+            have one entry for each x coordinate in the string.
+        xrefsrc
+            Sets the source reference on Chart Studio Cloud for
+            `xref`.
         xsizemode
             Sets the shapes's sizing mode along the x axis. If set
             to "scaled", `x0`, `x1` and x coordinates within `path`
@@ -25253,7 +25263,9 @@ def add_shape(
             data or plot fraction but `x0`, `x1` and x coordinates
             within `path` are pixels relative to `xanchor`. This
             way, the shape can have a fixed width while maintaining
-            a position relative to data or plot fraction.
+            a position relative to data or plot fraction. Note:
+            `xsizemode` "pixel" is not supported when `xref` is an
+            array.
         y0
             Sets the shape's starting y position. See `type` and
             `ysizemode` for more info.
@@ -25290,7 +25302,15 @@ def add_shape(
             domain of that axis: e.g., *y2 domain* refers to the
             domain of the second y  axis and a y position of 0.5
             refers to the point between the bottom and the top of
-            the domain of the second y axis.
+            the domain of the second y axis. If an array of axis
+            IDs is provided, each `y` value will refer to the
+            corresponding axis, e.g., ['y', 'y2'] for a rectangle,
+            line, or circle means `y0` uses the `y` axis and `y1`
+            uses the `y2` axis. Path shapes using an array should
+            have one entry for each y coordinate in the string.
+        yrefsrc
+            Sets the source reference on Chart Studio Cloud for
+            `yref`.
         ysizemode
             Sets the shapes's sizing mode along the y axis. If set
             to "scaled", `y0`, `y1` and y coordinates within `path`
@@ -25301,7 +25321,8 @@ def add_shape(
             within `path` are pixels relative to `yanchor`. This
             way, the shape can have a fixed height while
             maintaining a position relative to data or plot
-            fraction.
+            fraction. Note: `ysizemode` "pixel" is not supported
+            when `yref` is an array.
         row
             Subplot row for shape. If 'all', addresses all rows in
             the specified column(s).
@@ -25346,13 +25367,15 @@ def add_shape(
             x1shift=x1shift,
             xanchor=xanchor,
             xref=xref,
+            xrefsrc=xrefsrc,
             xsizemode=xsizemode,
             y0=y0,
             y0shift=y0shift,
             y1=y1,
             y1shift=y1shift,
             yanchor=yanchor,
             yref=yref,
+            yrefsrc=yrefsrc,
             ysizemode=ysizemode,
             **kwargs,
         )

js/package-lock.json

@@ -25076,13 +25076,15 @@ def add_shape(
         x1shift=None,
         xanchor=None,
         xref=None,
+        xrefsrc=None,
         xsizemode=None,
         y0=None,
         y0shift=None,
         y1=None,
         y1shift=None,
         yanchor=None,
         yref=None,
+        yrefsrc=None,
         ysizemode=None,
         row=None,
         col=None,
@@ -25247,7 +25249,15 @@ def add_shape(
             domain of that axis: e.g., *x2 domain* refers to the
             domain of the second x  axis and a x position of 0.5
             refers to the point between the left and the right of
-            the domain of the second x axis.
+            the domain of the second x axis. If an array of axis
+            IDs is provided, each `x` value will refer to the
+            corresponding axis, e.g., ['x', 'x2'] for a rectangle,
+            line, or circle means `x0` uses the `x` axis and `x1`
+            uses the `x2` axis. Path shapes using an array should
+            have one entry for each x coordinate in the string.
+        xrefsrc
+            Sets the source reference on Chart Studio Cloud for
+            `xref`.
         xsizemode
             Sets the shapes's sizing mode along the x axis. If set
             to "scaled", `x0`, `x1` and x coordinates within `path`
@@ -25257,7 +25267,9 @@ def add_shape(
             data or plot fraction but `x0`, `x1` and x coordinates
             within `path` are pixels relative to `xanchor`. This
             way, the shape can have a fixed width while maintaining
-            a position relative to data or plot fraction.
+            a position relative to data or plot fraction. Note:
+            `xsizemode` "pixel" is not supported when `xref` is an
+            array.
         y0
             Sets the shape's starting y position. See `type` and
             `ysizemode` for more info.
@@ -25294,7 +25306,15 @@ def add_shape(
             domain of that axis: e.g., *y2 domain* refers to the
             domain of the second y  axis and a y position of 0.5
             refers to the point between the bottom and the top of
-            the domain of the second y axis.
+            the domain of the second y axis. If an array of axis
+            IDs is provided, each `y` value will refer to the
+            corresponding axis, e.g., ['y', 'y2'] for a rectangle,
+            line, or circle means `y0` uses the `y` axis and `y1`
+            uses the `y2` axis. Path shapes using an array should
+            have one entry for each y coordinate in the string.
+        yrefsrc
+            Sets the source reference on Chart Studio Cloud for
+            `yref`.
         ysizemode
             Sets the shapes's sizing mode along the y axis. If set
             to "scaled", `y0`, `y1` and y coordinates within `path`
@@ -25305,7 +25325,8 @@ def add_shape(
             within `path` are pixels relative to `yanchor`. This
             way, the shape can have a fixed height while
             maintaining a position relative to data or plot
-            fraction.
+            fraction. Note: `ysizemode` "pixel" is not supported
+            when `yref` is an array.
         row
             Subplot row for shape. If 'all', addresses all rows in
             the specified column(s).
@@ -25350,13 +25371,15 @@ def add_shape(
             x1shift=x1shift,
             xanchor=xanchor,
             xref=xref,
+            xrefsrc=xrefsrc,
             xsizemode=xsizemode,
             y0=y0,
             y0shift=y0shift,
             y1=y1,
             y1shift=y1shift,
             yanchor=yanchor,
             yref=yref,
+            yrefsrc=yrefsrc,
             ysizemode=ysizemode,
             **kwargs,
         )

js/package.json

@@ -25,6 +25,8 @@ class Legend(_BaseLayoutHierarchyType):
         "maxheight",
         "orientation",
         "title",
+        "titleclick",
+        "titledoubleclick",
         "tracegroupgap",
         "traceorder",
         "uirevision",
@@ -373,6 +375,55 @@ def title(self):
     def title(self, val):
         self["title"] = val
 
+    @property
+    def titleclick(self):
+        """
+        Determines the behavior on legend title click. "toggle" toggles
+        the visibility of all items in the legend. "toggleothers"
+        toggles the visibility of all other legends. False disables
+        legend title click interactions. Defaults to "toggle" when
+        there are multiple legends, False otherwise. Not supported for
+        legends containing pie and pie-like traces.
+
+        The 'titleclick' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['toggle', 'toggleothers', False]
+
+        Returns
+        -------
+        Any
+        """
+        return self["titleclick"]
+
+    @titleclick.setter
+    def titleclick(self, val):
+        self["titleclick"] = val
+
+    @property
+    def titledoubleclick(self):
+        """
+        Determines the behavior on legend title double-click. "toggle"
+        toggles the visibility of all items in the legend.
+        "toggleothers" toggles the visibility of all other legends.
+        False disables legend title double-click interactions. Defaults
+        to "toggleothers" when there are multiple legends, False
+        otherwise. Not supported for legends containing pie and pie-
+        like traces.
+
+        The 'titledoubleclick' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['toggle', 'toggleothers', False]
+
+        Returns
+        -------
+        Any
+        """
+        return self["titledoubleclick"]
+
+    @titledoubleclick.setter
+    def titledoubleclick(self, val):
+        self["titledoubleclick"] = val
+
     @property
     def tracegroupgap(self):
         """
@@ -680,6 +731,22 @@ def _prop_descriptions(self):
         title
             :class:`plotly.graph_objects.layout.legend.Title`
             instance or dict with compatible properties
+        titleclick
+            Determines the behavior on legend title click. "toggle"
+            toggles the visibility of all items in the legend.
+            "toggleothers" toggles the visibility of all other
+            legends. False disables legend title click
+            interactions. Defaults to "toggle" when there are
+            multiple legends, False otherwise. Not supported for
+            legends containing pie and pie-like traces.
+        titledoubleclick
+            Determines the behavior on legend title double-click.
+            "toggle" toggles the visibility of all items in the
+            legend. "toggleothers" toggles the visibility of all
+            other legends. False disables legend title double-click
+            interactions. Defaults to "toggleothers" when there are
+            multiple legends, False otherwise. Not supported for
+            legends containing pie and pie-like traces.
         tracegroupgap
             Sets the amount of vertical space (in px) between
             legend groups.
@@ -765,6 +832,8 @@ def __init__(
         maxheight=None,
         orientation=None,
         title=None,
+        titleclick=None,
+        titledoubleclick=None,
         tracegroupgap=None,
         traceorder=None,
         uirevision=None,
@@ -849,6 +918,22 @@ def __init__(
         title
             :class:`plotly.graph_objects.layout.legend.Title`
             instance or dict with compatible properties
+        titleclick
+            Determines the behavior on legend title click. "toggle"
+            toggles the visibility of all items in the legend.
+            "toggleothers" toggles the visibility of all other
+            legends. False disables legend title click
+            interactions. Defaults to "toggle" when there are
+            multiple legends, False otherwise. Not supported for
+            legends containing pie and pie-like traces.
+        titledoubleclick
+            Determines the behavior on legend title double-click.
+            "toggle" toggles the visibility of all items in the
+            legend. "toggleothers" toggles the visibility of all
+            other legends. False disables legend title double-click
+            interactions. Defaults to "toggleothers" when there are
+            multiple legends, False otherwise. Not supported for
+            legends containing pie and pie-like traces.
         tracegroupgap
             Sets the amount of vertical space (in px) between
             legend groups.
@@ -954,6 +1039,8 @@ def __init__(
         self._set_property("maxheight", arg, maxheight)
         self._set_property("orientation", arg, orientation)
         self._set_property("title", arg, title)
+        self._set_property("titleclick", arg, titleclick)
+        self._set_property("titledoubleclick", arg, titledoubleclick)
         self._set_property("tracegroupgap", arg, tracegroupgap)
         self._set_property("traceorder", arg, traceorder)
         self._set_property("uirevision", arg, uirevision)