@@ -32,6 +32,7 @@ class Bar(_BaseTraceType):
32
32
"insidetextanchor" ,
33
33
"insidetextfont" ,
34
34
"legendgroup" ,
35
+ "legendgrouptitle" ,
35
36
"legendrank" ,
36
37
"marker" ,
37
38
"meta" ,
@@ -797,6 +798,34 @@ def legendgroup(self):
797
798
def legendgroup (self , val ):
798
799
self ["legendgroup" ] = val
799
800
801
+ # legendgrouptitle
802
+ # ----------------
803
+ @property
804
+ def legendgrouptitle (self ):
805
+ """
806
+ The 'legendgrouptitle' property is an instance of Legendgrouptitle
807
+ that may be specified as:
808
+ - An instance of :class:`plotly.graph_objs.bar.Legendgrouptitle`
809
+ - A dict of string/value properties that will be passed
810
+ to the Legendgrouptitle constructor
811
+
812
+ Supported dict properties:
813
+
814
+ font
815
+ Sets this legend group's title font.
816
+ text
817
+ Sets the title of the legend group.
818
+
819
+ Returns
820
+ -------
821
+ plotly.graph_objs.bar.Legendgrouptitle
822
+ """
823
+ return self ["legendgrouptitle" ]
824
+
825
+ @legendgrouptitle .setter
826
+ def legendgrouptitle (self , val ):
827
+ self ["legendgrouptitle" ] = val
828
+
800
829
# legendrank
801
830
# ----------
802
831
@property
@@ -1765,12 +1794,16 @@ def xcalendar(self, val):
1765
1794
@property
1766
1795
def xhoverformat (self ):
1767
1796
"""
1768
- Sets the hover text formatting rule for `x` using d3
1769
- formatting mini-languages which are very similar to those in
1770
- Python. See: https://github.com/d3/d3-3.x-api-
1771
- reference/blob/master/Formatting.md#d3_format And for dates
1772
- see: https://github.com/d3/d3-time-format#locale_format By
1773
- default the values are formatted using `xaxis.hoverformat`.
1797
+ Sets the hover text formatting rulefor `x` using d3 formatting
1798
+ mini-languages which are very similar to those in Python. For
1799
+ numbers, see: https://github.com/d3/d3-3.x-api-
1800
+ reference/blob/master/Formatting.md#d3_format. And for dates
1801
+ see: https://github.com/d3/d3-time-format#locale_format. We add
1802
+ two items to d3's date formatter: "%h" for half of the year as
1803
+ a decimal number as well as "%{n}f" for fractional seconds with
1804
+ n digits. For example, *2016-10-13 09:15:23.456* with
1805
+ tickformat "%H~%M~%S.%2f" would display *09~15~23.46*By default
1806
+ the values are formatted using `xaxis.hoverformat`.
1774
1807
1775
1808
The 'xhoverformat' property is a string and must be specified as:
1776
1809
- A string
@@ -1968,12 +2001,16 @@ def ycalendar(self, val):
1968
2001
@property
1969
2002
def yhoverformat (self ):
1970
2003
"""
1971
- Sets the hover text formatting rule for `y` using d3
1972
- formatting mini-languages which are very similar to those in
1973
- Python. See: https://github.com/d3/d3-3.x-api-
1974
- reference/blob/master/Formatting.md#d3_format And for dates
1975
- see: https://github.com/d3/d3-time-format#locale_format By
1976
- default the values are formatted using `yaxis.hoverformat`.
2004
+ Sets the hover text formatting rulefor `y` using d3 formatting
2005
+ mini-languages which are very similar to those in Python. For
2006
+ numbers, see: https://github.com/d3/d3-3.x-api-
2007
+ reference/blob/master/Formatting.md#d3_format. And for dates
2008
+ see: https://github.com/d3/d3-time-format#locale_format. We add
2009
+ two items to d3's date formatter: "%h" for half of the year as
2010
+ a decimal number as well as "%{n}f" for fractional seconds with
2011
+ n digits. For example, *2016-10-13 09:15:23.456* with
2012
+ tickformat "%H~%M~%S.%2f" would display *09~15~23.46*By default
2013
+ the values are formatted using `yaxis.hoverformat`.
1977
2014
1978
2015
The 'yhoverformat' property is a string and must be specified as:
1979
2016
- A string
@@ -2195,6 +2232,9 @@ def _prop_descriptions(self):
2195
2232
Sets the legend group for this trace. Traces part of
2196
2233
the same legend group hide/show at the same time when
2197
2234
toggling legend items.
2235
+ legendgrouptitle
2236
+ :class:`plotly.graph_objects.bar.Legendgrouptitle`
2237
+ instance or dict with compatible properties
2198
2238
legendrank
2199
2239
Sets the legend rank for this trace. Items and groups
2200
2240
with smaller ranks are presented on top/left side while
@@ -2361,13 +2401,19 @@ def _prop_descriptions(self):
2361
2401
xcalendar
2362
2402
Sets the calendar system to use with `x` date data.
2363
2403
xhoverformat
2364
- Sets the hover text formatting rule for `x` using d3
2404
+ Sets the hover text formatting rulefor `x` using d3
2365
2405
formatting mini-languages which are very similar to
2366
- those in Python. See: https://github.com/d3/d3-3.x-api-
2367
- reference/blob/master/Formatting.md#d3_format And for
2406
+ those in Python. For numbers, see:
2407
+ https://github.com/d3/d3-3.x-api-
2408
+ reference/blob/master/Formatting.md#d3_format. And for
2368
2409
dates see: https://github.com/d3/d3-time-
2369
- format#locale_format By default the values are
2370
- formatted using `xaxis.hoverformat`.
2410
+ format#locale_format. We add two items to d3's date
2411
+ formatter: "%h" for half of the year as a decimal
2412
+ number as well as "%{n}f" for fractional seconds with n
2413
+ digits. For example, *2016-10-13 09:15:23.456* with
2414
+ tickformat "%H~%M~%S.%2f" would display *09~15~23.46*By
2415
+ default the values are formatted using
2416
+ `xaxis.hoverformat`.
2371
2417
xperiod
2372
2418
Only relevant when the axis `type` is "date". Sets the
2373
2419
period positioning in milliseconds or "M<n>" on the x
@@ -2401,13 +2447,19 @@ def _prop_descriptions(self):
2401
2447
ycalendar
2402
2448
Sets the calendar system to use with `y` date data.
2403
2449
yhoverformat
2404
- Sets the hover text formatting rule for `y` using d3
2450
+ Sets the hover text formatting rulefor `y` using d3
2405
2451
formatting mini-languages which are very similar to
2406
- those in Python. See: https://github.com/d3/d3-3.x-api-
2407
- reference/blob/master/Formatting.md#d3_format And for
2452
+ those in Python. For numbers, see:
2453
+ https://github.com/d3/d3-3.x-api-
2454
+ reference/blob/master/Formatting.md#d3_format. And for
2408
2455
dates see: https://github.com/d3/d3-time-
2409
- format#locale_format By default the values are
2410
- formatted using `yaxis.hoverformat`.
2456
+ format#locale_format. We add two items to d3's date
2457
+ formatter: "%h" for half of the year as a decimal
2458
+ number as well as "%{n}f" for fractional seconds with n
2459
+ digits. For example, *2016-10-13 09:15:23.456* with
2460
+ tickformat "%H~%M~%S.%2f" would display *09~15~23.46*By
2461
+ default the values are formatted using
2462
+ `yaxis.hoverformat`.
2411
2463
yperiod
2412
2464
Only relevant when the axis `type` is "date". Sets the
2413
2465
period positioning in milliseconds or "M<n>" on the y
@@ -2455,6 +2507,7 @@ def __init__(
2455
2507
insidetextanchor = None ,
2456
2508
insidetextfont = None ,
2457
2509
legendgroup = None ,
2510
+ legendgrouptitle = None ,
2458
2511
legendrank = None ,
2459
2512
marker = None ,
2460
2513
meta = None ,
@@ -2625,6 +2678,9 @@ def __init__(
2625
2678
Sets the legend group for this trace. Traces part of
2626
2679
the same legend group hide/show at the same time when
2627
2680
toggling legend items.
2681
+ legendgrouptitle
2682
+ :class:`plotly.graph_objects.bar.Legendgrouptitle`
2683
+ instance or dict with compatible properties
2628
2684
legendrank
2629
2685
Sets the legend rank for this trace. Items and groups
2630
2686
with smaller ranks are presented on top/left side while
@@ -2791,13 +2847,19 @@ def __init__(
2791
2847
xcalendar
2792
2848
Sets the calendar system to use with `x` date data.
2793
2849
xhoverformat
2794
- Sets the hover text formatting rule for `x` using d3
2850
+ Sets the hover text formatting rulefor `x` using d3
2795
2851
formatting mini-languages which are very similar to
2796
- those in Python. See: https://github.com/d3/d3-3.x-api-
2797
- reference/blob/master/Formatting.md#d3_format And for
2852
+ those in Python. For numbers, see:
2853
+ https://github.com/d3/d3-3.x-api-
2854
+ reference/blob/master/Formatting.md#d3_format. And for
2798
2855
dates see: https://github.com/d3/d3-time-
2799
- format#locale_format By default the values are
2800
- formatted using `xaxis.hoverformat`.
2856
+ format#locale_format. We add two items to d3's date
2857
+ formatter: "%h" for half of the year as a decimal
2858
+ number as well as "%{n}f" for fractional seconds with n
2859
+ digits. For example, *2016-10-13 09:15:23.456* with
2860
+ tickformat "%H~%M~%S.%2f" would display *09~15~23.46*By
2861
+ default the values are formatted using
2862
+ `xaxis.hoverformat`.
2801
2863
xperiod
2802
2864
Only relevant when the axis `type` is "date". Sets the
2803
2865
period positioning in milliseconds or "M<n>" on the x
@@ -2831,13 +2893,19 @@ def __init__(
2831
2893
ycalendar
2832
2894
Sets the calendar system to use with `y` date data.
2833
2895
yhoverformat
2834
- Sets the hover text formatting rule for `y` using d3
2896
+ Sets the hover text formatting rulefor `y` using d3
2835
2897
formatting mini-languages which are very similar to
2836
- those in Python. See: https://github.com/d3/d3-3.x-api-
2837
- reference/blob/master/Formatting.md#d3_format And for
2898
+ those in Python. For numbers, see:
2899
+ https://github.com/d3/d3-3.x-api-
2900
+ reference/blob/master/Formatting.md#d3_format. And for
2838
2901
dates see: https://github.com/d3/d3-time-
2839
- format#locale_format By default the values are
2840
- formatted using `yaxis.hoverformat`.
2902
+ format#locale_format. We add two items to d3's date
2903
+ formatter: "%h" for half of the year as a decimal
2904
+ number as well as "%{n}f" for fractional seconds with n
2905
+ digits. For example, *2016-10-13 09:15:23.456* with
2906
+ tickformat "%H~%M~%S.%2f" would display *09~15~23.46*By
2907
+ default the values are formatted using
2908
+ `yaxis.hoverformat`.
2841
2909
yperiod
2842
2910
Only relevant when the axis `type` is "date". Sets the
2843
2911
period positioning in milliseconds or "M<n>" on the y
@@ -2983,6 +3051,10 @@ def __init__(
2983
3051
_v = legendgroup if legendgroup is not None else _v
2984
3052
if _v is not None :
2985
3053
self ["legendgroup" ] = _v
3054
+ _v = arg .pop ("legendgrouptitle" , None )
3055
+ _v = legendgrouptitle if legendgrouptitle is not None else _v
3056
+ if _v is not None :
3057
+ self ["legendgrouptitle" ] = _v
2986
3058
_v = arg .pop ("legendrank" , None )
2987
3059
_v = legendrank if legendrank is not None else _v
2988
3060
if _v is not None :
0 commit comments