update to plotyjs 2.20.0

Author: LiamConnors

packages/javascript/jupyterlab-plotly/package-lock.json

@@ -65,7 +65,7 @@
     "@lumino/messaging": "^1.2.3",
     "@lumino/widgets": "^1.8.1",
     "lodash": "^4.17.4",
-    "plotly.js": "^2.19.1"
+    "plotly.js": "^2.20.0"
   },
   "jupyterlab": {
     "extension": "lib/jupyterlab-plugin",

packages/javascript/jupyterlab-plotly/package.json

@@ -9661,6 +9661,12 @@
     }
    },
    "title": {
+    "automargin": {
+     "description": "Determines whether the title can automatically push the figure margins. If `yref='paper'` then the margin will expand to ensure that the title doesn’t overlap with the edges of the container. If `yref='container'` then the margins will ensure that the title doesn’t overlap with the plot area, tick labels, and axis titles. If `automargin=true` and the margins need to be expanded, then y will be set to a default 1 and yanchor will be set to an appropriate default to ensure that minimal margin space is needed. Note that when `yref='paper'`, only 1 or 0 are allowed y values. Invalid values will be reset to the default 1.",
+     "dflt": false,
+     "editType": "plot",
+     "valType": "boolean"
+    },
     "editType": "layoutstyle",
     "font": {
      "color": {

packages/python/plotly/codegen/resources/plot-schema.json

@@ -3609,6 +3609,22 @@ def title(self):
 
             Supported dict properties:
 
+                automargin
+                    Determines whether the title can automatically
+                    push the figure margins. If `yref='paper'` then
+                    the margin will expand to ensure that the title
+                    doesn’t overlap with the edges of the
+                    container. If `yref='container'` then the
+                    margins will ensure that the title doesn’t
+                    overlap with the plot area, tick labels, and
+                    axis titles. If `automargin=true` and the
+                    margins need to be expanded, then y will be set
+                    to a default 1 and yanchor will be set to an
+                    appropriate default to ensure that minimal
+                    margin space is needed. Note that when
+                    `yref='paper'`, only 1 or 0 are allowed y
+                    values. Invalid values will be reset to the
+                    default 1.
                 font
                     Sets the title font. Note that the title's font
                     used to be customized by the now deprecated

packages/python/plotly/plotly/graph_objs/_layout.py

@@ -9,6 +9,7 @@ class Title(_BaseLayoutHierarchyType):
     _parent_path_str = "layout"
     _path_str = "layout.title"
     _valid_props = {
+        "automargin",
         "font",
         "pad",
         "text",
@@ -20,6 +21,36 @@ class Title(_BaseLayoutHierarchyType):
         "yref",
     }
 
+    # automargin
+    # ----------
+    @property
+    def automargin(self):
+        """
+        Determines whether the title can automatically push the figure
+        margins. If `yref='paper'` then the margin will expand to
+        ensure that the title doesn’t overlap with the edges of the
+        container. If `yref='container'` then the margins will ensure
+        that the title doesn’t overlap with the plot area, tick labels,
+        and axis titles. If `automargin=true` and the margins need to
+        be expanded, then y will be set to a default 1 and yanchor will
+        be set to an appropriate default to ensure that minimal margin
+        space is needed. Note that when `yref='paper'`, only 1 or 0 are
+        allowed y values. Invalid values will be reset to the default
+        1.
+
+        The 'automargin' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["automargin"]
+
+    @automargin.setter
+    def automargin(self, val):
+        self["automargin"] = val
+
     # font
     # ----
     @property
@@ -280,6 +311,19 @@ def yref(self, val):
     @property
     def _prop_descriptions(self):
         return """\
+        automargin
+            Determines whether the title can automatically push the
+            figure margins. If `yref='paper'` then the margin will
+            expand to ensure that the title doesn’t overlap with
+            the edges of the container. If `yref='container'` then
+            the margins will ensure that the title doesn’t overlap
+            with the plot area, tick labels, and axis titles. If
+            `automargin=true` and the margins need to be expanded,
+            then y will be set to a default 1 and yanchor will be
+            set to an appropriate default to ensure that minimal
+            margin space is needed. Note that when `yref='paper'`,
+            only 1 or 0 are allowed y values. Invalid values will
+            be reset to the default 1.
         font
             Sets the title font. Note that the title's font used to
             be customized by the now deprecated `titlefont`
@@ -332,6 +376,7 @@ def _prop_descriptions(self):
     def __init__(
         self,
         arg=None,
+        automargin=None,
         font=None,
         pad=None,
         text=None,
@@ -351,6 +396,19 @@ def __init__(
         arg
             dict of properties compatible with this constructor or
             an instance of :class:`plotly.graph_objs.layout.Title`
+        automargin
+            Determines whether the title can automatically push the
+            figure margins. If `yref='paper'` then the margin will
+            expand to ensure that the title doesn’t overlap with
+            the edges of the container. If `yref='container'` then
+            the margins will ensure that the title doesn’t overlap
+            with the plot area, tick labels, and axis titles. If
+            `automargin=true` and the margins need to be expanded,
+            then y will be set to a default 1 and yanchor will be
+            set to an appropriate default to ensure that minimal
+            margin space is needed. Note that when `yref='paper'`,
+            only 1 or 0 are allowed y values. Invalid values will
+            be reset to the default 1.
         font
             Sets the title font. Note that the title's font used to
             be customized by the now deprecated `titlefont`
@@ -432,6 +490,10 @@ def __init__(
 
         # Populate data dict with properties
         # ----------------------------------
+        _v = arg.pop("automargin", None)
+        _v = automargin if automargin is not None else _v
+        if _v is not None:
+            self["automargin"] = _v
         _v = arg.pop("font", None)
         _v = font if font is not None else _v
         if _v is not None:

packages/python/plotly/plotly/graph_objs/layout/_title.py

@@ -1,3 +1,3 @@
 # DO NOT EDIT
 # This file is generated by the updatebundle setup.py command
-__plotlyjs_version__ = "2.19.1"
+__plotlyjs_version__ = "2.20.0"

packages/python/plotly/plotly/offline/_plotlyjs_version.py

@@ -10,6 +10,22 @@ def __init__(self, plotly_name="title", parent_name="layout", **kwargs):
             data_docs=kwargs.pop(
                 "data_docs",
                 """
+            automargin
+                Determines whether the title can automatically
+                push the figure margins. If `yref='paper'` then
+                the margin will expand to ensure that the title
+                doesn’t overlap with the edges of the
+                container. If `yref='container'` then the
+                margins will ensure that the title doesn’t
+                overlap with the plot area, tick labels, and
+                axis titles. If `automargin=true` and the
+                margins need to be expanded, then y will be set
+                to a default 1 and yanchor will be set to an
+                appropriate default to ensure that minimal
+                margin space is needed. Note that when
+                `yref='paper'`, only 1 or 0 are allowed y
+                values. Invalid values will be reset to the
+                default 1.
             font
                 Sets the title font. Note that the title's font
                 used to be customized by the now deprecated

packages/python/plotly/plotly/package_data/plotly.min.js

@@ -11,6 +11,7 @@
     from ._text import TextValidator
     from ._pad import PadValidator
     from ._font import FontValidator
+    from ._automargin import AutomarginValidator
 else:
     from _plotly_utils.importers import relative_import
 
@@ -27,5 +28,6 @@
             "._text.TextValidator",
             "._pad.PadValidator",
             "._font.FontValidator",
+            "._automargin.AutomarginValidator",
         ],
     )

packages/python/plotly/plotly/validators/layout/_title.py

@@ -0,0 +1,11 @@
+import _plotly_utils.basevalidators
+
+
+class AutomarginValidator(_plotly_utils.basevalidators.BooleanValidator):
+    def __init__(self, plotly_name="automargin", parent_name="layout.title", **kwargs):
+        super(AutomarginValidator, self).__init__(
+            plotly_name=plotly_name,
+            parent_name=parent_name,
+            edit_type=kwargs.pop("edit_type", "plot"),
+            **kwargs,
+        )