expand doc string for handle_style

ianhi · ianhi · commit 8bd6adbe7d41 · 2021-06-23T17:22:19.000-04:00
diff --git a/lib/matplotlib/widgets.py b/lib/matplotlib/widgets.py
@@ -386,7 +386,7 @@ def __init__(self, ax, label, valmin, valmax, valinit=0.5, valfmt=None,
             further styling via the *track* attribute.
 
         handle_style : dict
-            Properties of the slider handle. Supported values are
+            Properties of the slider handle. Default values are
 
             ========= ===== ======= ========================================
             Key       Value Default Description
@@ -396,6 +396,10 @@ def __init__(self, ax, label, valmin, valmax, valinit=0.5, valfmt=None,
             size      int   10      The size of the slider handle in points.
             ========= ===== ======= ========================================
 
+            Other values will be transformed as marker{foo} and passed to the
+            `~.Line2D` constructor. e.g. ``handle_style = {'style'='x'}`` will
+            result in ``markerstyle = 'x'``.
+
         Notes
         -----
         Additional kwargs are passed on to ``self.poly`` which is the
@@ -420,8 +424,10 @@ def __init__(self, ax, label, valmin, valmax, valinit=0.5, valfmt=None,
         self.val = valinit
         self.valinit = valinit
 
-        defaults = {'facecolor':'white', 'edgecolor':'.75', 'size':10}
-        marker_props = {f'marker{k}': v for k, v in {**defaults, **handle_style}}
+        defaults = {'facecolor': 'white', 'edgecolor': '.75', 'size': 10}
+        marker_props = {
+            f'marker{k}': v for k, v in {**defaults, **handle_style}
+        }
 
         if orientation == 'vertical':
             self.track = Rectangle(
@@ -647,7 +653,7 @@ def __init__(
             further styling via the *track* attribute.
 
         handle_style : dict
-            Properties of the slider handles. Supported values are
+            Properties of the slider handles. Default values are
 
             ========= ===== ======= =========================================
             Key       Value Default Description
@@ -657,6 +663,10 @@ def __init__(
             size      int   10      The size of the slider handles in points.
             ========= ===== ======= =========================================
 
+            Other values will be transformed as marker{foo} and passed to the
+            `~.Line2D` constructor. e.g. ``handle_style = {'style'='x'}`` will
+            result in ``markerstyle = 'x'``.
+
         Notes
         -----
         Additional kwargs are passed on to ``self.poly`` which is the
@@ -679,13 +689,10 @@ def __init__(
         self.val = valinit
         self.valinit = valinit
 
-        marker_props = {}
-        defaults = {'facecolor':'white', 'edgecolor':'.75', 'size':10}
-        if handle_style is not None:
-            for k in ['facecolor', 'edgecolor', 'size']:
-                marker_props[f'marker{k}'] = handle_style.get(k, defaults[k])
-        else:
-            marker_props = {f'marker{k}': v for k, v in defaults.items()}
+        defaults = {'facecolor': 'white', 'edgecolor': '.75', 'size': 10}
+        marker_props = {
+            f'marker{k}': v for k, v in {**defaults, **handle_style}
+        }
 
         if orientation == "vertical":
             self.track = Rectangle(
