mirror of
https://github.com/aykhans/AzSuicideDataVisualization.git
synced 2025-07-01 14:07:48 +00:00
906 lines
31 KiB
Python
906 lines
31 KiB
Python
from plotly.basedatatypes import BaseLayoutHierarchyType as _BaseLayoutHierarchyType
|
|
import copy as _copy
|
|
|
|
|
|
class Updatemenu(_BaseLayoutHierarchyType):
|
|
|
|
# class properties
|
|
# --------------------
|
|
_parent_path_str = "layout"
|
|
_path_str = "layout.updatemenu"
|
|
_valid_props = {
|
|
"active",
|
|
"bgcolor",
|
|
"bordercolor",
|
|
"borderwidth",
|
|
"buttondefaults",
|
|
"buttons",
|
|
"direction",
|
|
"font",
|
|
"name",
|
|
"pad",
|
|
"showactive",
|
|
"templateitemname",
|
|
"type",
|
|
"visible",
|
|
"x",
|
|
"xanchor",
|
|
"y",
|
|
"yanchor",
|
|
}
|
|
|
|
# active
|
|
# ------
|
|
@property
|
|
def active(self):
|
|
"""
|
|
Determines which button (by index starting from 0) is
|
|
considered active.
|
|
|
|
The 'active' property is a integer and may be specified as:
|
|
- An int (or float that will be cast to an int)
|
|
in the interval [-1, 9223372036854775807]
|
|
|
|
Returns
|
|
-------
|
|
int
|
|
"""
|
|
return self["active"]
|
|
|
|
@active.setter
|
|
def active(self, val):
|
|
self["active"] = val
|
|
|
|
# bgcolor
|
|
# -------
|
|
@property
|
|
def bgcolor(self):
|
|
"""
|
|
Sets the background color of the update menu buttons.
|
|
|
|
The 'bgcolor' property is a color and may be specified as:
|
|
- A hex string (e.g. '#ff0000')
|
|
- An rgb/rgba string (e.g. 'rgb(255,0,0)')
|
|
- An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
|
|
- An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
|
|
- A named CSS color:
|
|
aliceblue, antiquewhite, aqua, aquamarine, azure,
|
|
beige, bisque, black, blanchedalmond, blue,
|
|
blueviolet, brown, burlywood, cadetblue,
|
|
chartreuse, chocolate, coral, cornflowerblue,
|
|
cornsilk, crimson, cyan, darkblue, darkcyan,
|
|
darkgoldenrod, darkgray, darkgrey, darkgreen,
|
|
darkkhaki, darkmagenta, darkolivegreen, darkorange,
|
|
darkorchid, darkred, darksalmon, darkseagreen,
|
|
darkslateblue, darkslategray, darkslategrey,
|
|
darkturquoise, darkviolet, deeppink, deepskyblue,
|
|
dimgray, dimgrey, dodgerblue, firebrick,
|
|
floralwhite, forestgreen, fuchsia, gainsboro,
|
|
ghostwhite, gold, goldenrod, gray, grey, green,
|
|
greenyellow, honeydew, hotpink, indianred, indigo,
|
|
ivory, khaki, lavender, lavenderblush, lawngreen,
|
|
lemonchiffon, lightblue, lightcoral, lightcyan,
|
|
lightgoldenrodyellow, lightgray, lightgrey,
|
|
lightgreen, lightpink, lightsalmon, lightseagreen,
|
|
lightskyblue, lightslategray, lightslategrey,
|
|
lightsteelblue, lightyellow, lime, limegreen,
|
|
linen, magenta, maroon, mediumaquamarine,
|
|
mediumblue, mediumorchid, mediumpurple,
|
|
mediumseagreen, mediumslateblue, mediumspringgreen,
|
|
mediumturquoise, mediumvioletred, midnightblue,
|
|
mintcream, mistyrose, moccasin, navajowhite, navy,
|
|
oldlace, olive, olivedrab, orange, orangered,
|
|
orchid, palegoldenrod, palegreen, paleturquoise,
|
|
palevioletred, papayawhip, peachpuff, peru, pink,
|
|
plum, powderblue, purple, red, rosybrown,
|
|
royalblue, rebeccapurple, saddlebrown, salmon,
|
|
sandybrown, seagreen, seashell, sienna, silver,
|
|
skyblue, slateblue, slategray, slategrey, snow,
|
|
springgreen, steelblue, tan, teal, thistle, tomato,
|
|
turquoise, violet, wheat, white, whitesmoke,
|
|
yellow, yellowgreen
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
"""
|
|
return self["bgcolor"]
|
|
|
|
@bgcolor.setter
|
|
def bgcolor(self, val):
|
|
self["bgcolor"] = val
|
|
|
|
# bordercolor
|
|
# -----------
|
|
@property
|
|
def bordercolor(self):
|
|
"""
|
|
Sets the color of the border enclosing the update menu.
|
|
|
|
The 'bordercolor' property is a color and may be specified as:
|
|
- A hex string (e.g. '#ff0000')
|
|
- An rgb/rgba string (e.g. 'rgb(255,0,0)')
|
|
- An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
|
|
- An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
|
|
- A named CSS color:
|
|
aliceblue, antiquewhite, aqua, aquamarine, azure,
|
|
beige, bisque, black, blanchedalmond, blue,
|
|
blueviolet, brown, burlywood, cadetblue,
|
|
chartreuse, chocolate, coral, cornflowerblue,
|
|
cornsilk, crimson, cyan, darkblue, darkcyan,
|
|
darkgoldenrod, darkgray, darkgrey, darkgreen,
|
|
darkkhaki, darkmagenta, darkolivegreen, darkorange,
|
|
darkorchid, darkred, darksalmon, darkseagreen,
|
|
darkslateblue, darkslategray, darkslategrey,
|
|
darkturquoise, darkviolet, deeppink, deepskyblue,
|
|
dimgray, dimgrey, dodgerblue, firebrick,
|
|
floralwhite, forestgreen, fuchsia, gainsboro,
|
|
ghostwhite, gold, goldenrod, gray, grey, green,
|
|
greenyellow, honeydew, hotpink, indianred, indigo,
|
|
ivory, khaki, lavender, lavenderblush, lawngreen,
|
|
lemonchiffon, lightblue, lightcoral, lightcyan,
|
|
lightgoldenrodyellow, lightgray, lightgrey,
|
|
lightgreen, lightpink, lightsalmon, lightseagreen,
|
|
lightskyblue, lightslategray, lightslategrey,
|
|
lightsteelblue, lightyellow, lime, limegreen,
|
|
linen, magenta, maroon, mediumaquamarine,
|
|
mediumblue, mediumorchid, mediumpurple,
|
|
mediumseagreen, mediumslateblue, mediumspringgreen,
|
|
mediumturquoise, mediumvioletred, midnightblue,
|
|
mintcream, mistyrose, moccasin, navajowhite, navy,
|
|
oldlace, olive, olivedrab, orange, orangered,
|
|
orchid, palegoldenrod, palegreen, paleturquoise,
|
|
palevioletred, papayawhip, peachpuff, peru, pink,
|
|
plum, powderblue, purple, red, rosybrown,
|
|
royalblue, rebeccapurple, saddlebrown, salmon,
|
|
sandybrown, seagreen, seashell, sienna, silver,
|
|
skyblue, slateblue, slategray, slategrey, snow,
|
|
springgreen, steelblue, tan, teal, thistle, tomato,
|
|
turquoise, violet, wheat, white, whitesmoke,
|
|
yellow, yellowgreen
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
"""
|
|
return self["bordercolor"]
|
|
|
|
@bordercolor.setter
|
|
def bordercolor(self, val):
|
|
self["bordercolor"] = val
|
|
|
|
# borderwidth
|
|
# -----------
|
|
@property
|
|
def borderwidth(self):
|
|
"""
|
|
Sets the width (in px) of the border enclosing the update menu.
|
|
|
|
The 'borderwidth' property is a number and may be specified as:
|
|
- An int or float in the interval [0, inf]
|
|
|
|
Returns
|
|
-------
|
|
int|float
|
|
"""
|
|
return self["borderwidth"]
|
|
|
|
@borderwidth.setter
|
|
def borderwidth(self, val):
|
|
self["borderwidth"] = val
|
|
|
|
# buttons
|
|
# -------
|
|
@property
|
|
def buttons(self):
|
|
"""
|
|
The 'buttons' property is a tuple of instances of
|
|
Button that may be specified as:
|
|
- A list or tuple of instances of plotly.graph_objs.layout.updatemenu.Button
|
|
- A list or tuple of dicts of string/value properties that
|
|
will be passed to the Button constructor
|
|
|
|
Supported dict properties:
|
|
|
|
args
|
|
Sets the arguments values to be passed to the
|
|
Plotly method set in `method` on click.
|
|
args2
|
|
Sets a 2nd set of `args`, these arguments
|
|
values are passed to the Plotly method set in
|
|
`method` when clicking this button while in the
|
|
active state. Use this to create toggle
|
|
buttons.
|
|
execute
|
|
When true, the API method is executed. When
|
|
false, all other behaviors are the same and
|
|
command execution is skipped. This may be
|
|
useful when hooking into, for example, the
|
|
`plotly_buttonclicked` method and executing the
|
|
API command manually without losing the benefit
|
|
of the updatemenu automatically binding to the
|
|
state of the plot through the specification of
|
|
`method` and `args`.
|
|
label
|
|
Sets the text label to appear on the button.
|
|
method
|
|
Sets the Plotly method to be called on click.
|
|
If the `skip` method is used, the API
|
|
updatemenu will function as normal but will
|
|
perform no API calls and will not bind
|
|
automatically to state updates. This may be
|
|
used to create a component interface and attach
|
|
to updatemenu events manually via JavaScript.
|
|
name
|
|
When used in a template, named items are
|
|
created in the output figure in addition to any
|
|
items the figure already has in this array. You
|
|
can modify these items in the output figure by
|
|
making your own item with `templateitemname`
|
|
matching this `name` alongside your
|
|
modifications (including `visible: false` or
|
|
`enabled: false` to hide it). Has no effect
|
|
outside of a template.
|
|
templateitemname
|
|
Used to refer to a named item in this array in
|
|
the template. Named items from the template
|
|
will be created even without a matching item in
|
|
the input figure, but you can modify one by
|
|
making an item with `templateitemname` matching
|
|
its `name`, alongside your modifications
|
|
(including `visible: false` or `enabled: false`
|
|
to hide it). If there is no template or no
|
|
matching item, this item will be hidden unless
|
|
you explicitly show it with `visible: true`.
|
|
visible
|
|
Determines whether or not this button is
|
|
visible.
|
|
|
|
Returns
|
|
-------
|
|
tuple[plotly.graph_objs.layout.updatemenu.Button]
|
|
"""
|
|
return self["buttons"]
|
|
|
|
@buttons.setter
|
|
def buttons(self, val):
|
|
self["buttons"] = val
|
|
|
|
# buttondefaults
|
|
# --------------
|
|
@property
|
|
def buttondefaults(self):
|
|
"""
|
|
When used in a template (as
|
|
layout.template.layout.updatemenu.buttondefaults), sets the
|
|
default property values to use for elements of
|
|
layout.updatemenu.buttons
|
|
|
|
The 'buttondefaults' property is an instance of Button
|
|
that may be specified as:
|
|
- An instance of :class:`plotly.graph_objs.layout.updatemenu.Button`
|
|
- A dict of string/value properties that will be passed
|
|
to the Button constructor
|
|
|
|
Supported dict properties:
|
|
|
|
Returns
|
|
-------
|
|
plotly.graph_objs.layout.updatemenu.Button
|
|
"""
|
|
return self["buttondefaults"]
|
|
|
|
@buttondefaults.setter
|
|
def buttondefaults(self, val):
|
|
self["buttondefaults"] = val
|
|
|
|
# direction
|
|
# ---------
|
|
@property
|
|
def direction(self):
|
|
"""
|
|
Determines the direction in which the buttons are laid out,
|
|
whether in a dropdown menu or a row/column of buttons. For
|
|
`left` and `up`, the buttons will still appear in left-to-right
|
|
or top-to-bottom order respectively.
|
|
|
|
The 'direction' property is an enumeration that may be specified as:
|
|
- One of the following enumeration values:
|
|
['left', 'right', 'up', 'down']
|
|
|
|
Returns
|
|
-------
|
|
Any
|
|
"""
|
|
return self["direction"]
|
|
|
|
@direction.setter
|
|
def direction(self, val):
|
|
self["direction"] = val
|
|
|
|
# font
|
|
# ----
|
|
@property
|
|
def font(self):
|
|
"""
|
|
Sets the font of the update menu button text.
|
|
|
|
The 'font' property is an instance of Font
|
|
that may be specified as:
|
|
- An instance of :class:`plotly.graph_objs.layout.updatemenu.Font`
|
|
- A dict of string/value properties that will be passed
|
|
to the Font constructor
|
|
|
|
Supported dict properties:
|
|
|
|
color
|
|
|
|
family
|
|
HTML font family - the typeface that will be
|
|
applied by the web browser. The web browser
|
|
will only be able to apply a font if it is
|
|
available on the system which it operates.
|
|
Provide multiple font families, separated by
|
|
commas, to indicate the preference in which to
|
|
apply fonts if they aren't available on the
|
|
system. The Chart Studio Cloud (at
|
|
https://chart-studio.plotly.com or on-premise)
|
|
generates images on a server, where only a
|
|
select number of fonts are installed and
|
|
supported. These include "Arial", "Balto",
|
|
"Courier New", "Droid Sans",, "Droid Serif",
|
|
"Droid Sans Mono", "Gravitas One", "Old
|
|
Standard TT", "Open Sans", "Overpass", "PT Sans
|
|
Narrow", "Raleway", "Times New Roman".
|
|
size
|
|
|
|
Returns
|
|
-------
|
|
plotly.graph_objs.layout.updatemenu.Font
|
|
"""
|
|
return self["font"]
|
|
|
|
@font.setter
|
|
def font(self, val):
|
|
self["font"] = val
|
|
|
|
# name
|
|
# ----
|
|
@property
|
|
def name(self):
|
|
"""
|
|
When used in a template, named items are created in the output
|
|
figure in addition to any items the figure already has in this
|
|
array. You can modify these items in the output figure by
|
|
making your own item with `templateitemname` matching this
|
|
`name` alongside your modifications (including `visible: false`
|
|
or `enabled: false` to hide it). Has no effect outside of a
|
|
template.
|
|
|
|
The 'name' property is a string and must be specified as:
|
|
- A string
|
|
- A number that will be converted to a string
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
"""
|
|
return self["name"]
|
|
|
|
@name.setter
|
|
def name(self, val):
|
|
self["name"] = val
|
|
|
|
# pad
|
|
# ---
|
|
@property
|
|
def pad(self):
|
|
"""
|
|
Sets the padding around the buttons or dropdown menu.
|
|
|
|
The 'pad' property is an instance of Pad
|
|
that may be specified as:
|
|
- An instance of :class:`plotly.graph_objs.layout.updatemenu.Pad`
|
|
- A dict of string/value properties that will be passed
|
|
to the Pad constructor
|
|
|
|
Supported dict properties:
|
|
|
|
b
|
|
The amount of padding (in px) along the bottom
|
|
of the component.
|
|
l
|
|
The amount of padding (in px) on the left side
|
|
of the component.
|
|
r
|
|
The amount of padding (in px) on the right side
|
|
of the component.
|
|
t
|
|
The amount of padding (in px) along the top of
|
|
the component.
|
|
|
|
Returns
|
|
-------
|
|
plotly.graph_objs.layout.updatemenu.Pad
|
|
"""
|
|
return self["pad"]
|
|
|
|
@pad.setter
|
|
def pad(self, val):
|
|
self["pad"] = val
|
|
|
|
# showactive
|
|
# ----------
|
|
@property
|
|
def showactive(self):
|
|
"""
|
|
Highlights active dropdown item or active button if true.
|
|
|
|
The 'showactive' property must be specified as a bool
|
|
(either True, or False)
|
|
|
|
Returns
|
|
-------
|
|
bool
|
|
"""
|
|
return self["showactive"]
|
|
|
|
@showactive.setter
|
|
def showactive(self, val):
|
|
self["showactive"] = val
|
|
|
|
# templateitemname
|
|
# ----------------
|
|
@property
|
|
def templateitemname(self):
|
|
"""
|
|
Used to refer to a named item in this array in the template.
|
|
Named items from the template will be created even without a
|
|
matching item in the input figure, but you can modify one by
|
|
making an item with `templateitemname` matching its `name`,
|
|
alongside your modifications (including `visible: false` or
|
|
`enabled: false` to hide it). If there is no template or no
|
|
matching item, this item will be hidden unless you explicitly
|
|
show it with `visible: true`.
|
|
|
|
The 'templateitemname' property is a string and must be specified as:
|
|
- A string
|
|
- A number that will be converted to a string
|
|
|
|
Returns
|
|
-------
|
|
str
|
|
"""
|
|
return self["templateitemname"]
|
|
|
|
@templateitemname.setter
|
|
def templateitemname(self, val):
|
|
self["templateitemname"] = val
|
|
|
|
# type
|
|
# ----
|
|
@property
|
|
def type(self):
|
|
"""
|
|
Determines whether the buttons are accessible via a dropdown
|
|
menu or whether the buttons are stacked horizontally or
|
|
vertically
|
|
|
|
The 'type' property is an enumeration that may be specified as:
|
|
- One of the following enumeration values:
|
|
['dropdown', 'buttons']
|
|
|
|
Returns
|
|
-------
|
|
Any
|
|
"""
|
|
return self["type"]
|
|
|
|
@type.setter
|
|
def type(self, val):
|
|
self["type"] = val
|
|
|
|
# visible
|
|
# -------
|
|
@property
|
|
def visible(self):
|
|
"""
|
|
Determines whether or not the update menu is visible.
|
|
|
|
The 'visible' property must be specified as a bool
|
|
(either True, or False)
|
|
|
|
Returns
|
|
-------
|
|
bool
|
|
"""
|
|
return self["visible"]
|
|
|
|
@visible.setter
|
|
def visible(self, val):
|
|
self["visible"] = val
|
|
|
|
# x
|
|
# -
|
|
@property
|
|
def x(self):
|
|
"""
|
|
Sets the x position (in normalized coordinates) of the update
|
|
menu.
|
|
|
|
The 'x' property is a number and may be specified as:
|
|
- An int or float in the interval [-2, 3]
|
|
|
|
Returns
|
|
-------
|
|
int|float
|
|
"""
|
|
return self["x"]
|
|
|
|
@x.setter
|
|
def x(self, val):
|
|
self["x"] = val
|
|
|
|
# xanchor
|
|
# -------
|
|
@property
|
|
def xanchor(self):
|
|
"""
|
|
Sets the update menu's horizontal position anchor. This anchor
|
|
binds the `x` position to the "left", "center" or "right" of
|
|
the range selector.
|
|
|
|
The 'xanchor' property is an enumeration that may be specified as:
|
|
- One of the following enumeration values:
|
|
['auto', 'left', 'center', 'right']
|
|
|
|
Returns
|
|
-------
|
|
Any
|
|
"""
|
|
return self["xanchor"]
|
|
|
|
@xanchor.setter
|
|
def xanchor(self, val):
|
|
self["xanchor"] = val
|
|
|
|
# y
|
|
# -
|
|
@property
|
|
def y(self):
|
|
"""
|
|
Sets the y position (in normalized coordinates) of the update
|
|
menu.
|
|
|
|
The 'y' property is a number and may be specified as:
|
|
- An int or float in the interval [-2, 3]
|
|
|
|
Returns
|
|
-------
|
|
int|float
|
|
"""
|
|
return self["y"]
|
|
|
|
@y.setter
|
|
def y(self, val):
|
|
self["y"] = val
|
|
|
|
# yanchor
|
|
# -------
|
|
@property
|
|
def yanchor(self):
|
|
"""
|
|
Sets the update menu's vertical position anchor This anchor
|
|
binds the `y` position to the "top", "middle" or "bottom" of
|
|
the range selector.
|
|
|
|
The 'yanchor' property is an enumeration that may be specified as:
|
|
- One of the following enumeration values:
|
|
['auto', 'top', 'middle', 'bottom']
|
|
|
|
Returns
|
|
-------
|
|
Any
|
|
"""
|
|
return self["yanchor"]
|
|
|
|
@yanchor.setter
|
|
def yanchor(self, val):
|
|
self["yanchor"] = val
|
|
|
|
# Self properties description
|
|
# ---------------------------
|
|
@property
|
|
def _prop_descriptions(self):
|
|
return """\
|
|
active
|
|
Determines which button (by index starting from 0) is
|
|
considered active.
|
|
bgcolor
|
|
Sets the background color of the update menu buttons.
|
|
bordercolor
|
|
Sets the color of the border enclosing the update menu.
|
|
borderwidth
|
|
Sets the width (in px) of the border enclosing the
|
|
update menu.
|
|
buttons
|
|
A tuple of
|
|
:class:`plotly.graph_objects.layout.updatemenu.Button`
|
|
instances or dicts with compatible properties
|
|
buttondefaults
|
|
When used in a template (as
|
|
layout.template.layout.updatemenu.buttondefaults), sets
|
|
the default property values to use for elements of
|
|
layout.updatemenu.buttons
|
|
direction
|
|
Determines the direction in which the buttons are laid
|
|
out, whether in a dropdown menu or a row/column of
|
|
buttons. For `left` and `up`, the buttons will still
|
|
appear in left-to-right or top-to-bottom order
|
|
respectively.
|
|
font
|
|
Sets the font of the update menu button text.
|
|
name
|
|
When used in a template, named items are created in the
|
|
output figure in addition to any items the figure
|
|
already has in this array. You can modify these items
|
|
in the output figure by making your own item with
|
|
`templateitemname` matching this `name` alongside your
|
|
modifications (including `visible: false` or `enabled:
|
|
false` to hide it). Has no effect outside of a
|
|
template.
|
|
pad
|
|
Sets the padding around the buttons or dropdown menu.
|
|
showactive
|
|
Highlights active dropdown item or active button if
|
|
true.
|
|
templateitemname
|
|
Used to refer to a named item in this array in the
|
|
template. Named items from the template will be created
|
|
even without a matching item in the input figure, but
|
|
you can modify one by making an item with
|
|
`templateitemname` matching its `name`, alongside your
|
|
modifications (including `visible: false` or `enabled:
|
|
false` to hide it). If there is no template or no
|
|
matching item, this item will be hidden unless you
|
|
explicitly show it with `visible: true`.
|
|
type
|
|
Determines whether the buttons are accessible via a
|
|
dropdown menu or whether the buttons are stacked
|
|
horizontally or vertically
|
|
visible
|
|
Determines whether or not the update menu is visible.
|
|
x
|
|
Sets the x position (in normalized coordinates) of the
|
|
update menu.
|
|
xanchor
|
|
Sets the update menu's horizontal position anchor. This
|
|
anchor binds the `x` position to the "left", "center"
|
|
or "right" of the range selector.
|
|
y
|
|
Sets the y position (in normalized coordinates) of the
|
|
update menu.
|
|
yanchor
|
|
Sets the update menu's vertical position anchor This
|
|
anchor binds the `y` position to the "top", "middle" or
|
|
"bottom" of the range selector.
|
|
"""
|
|
|
|
def __init__(
|
|
self,
|
|
arg=None,
|
|
active=None,
|
|
bgcolor=None,
|
|
bordercolor=None,
|
|
borderwidth=None,
|
|
buttons=None,
|
|
buttondefaults=None,
|
|
direction=None,
|
|
font=None,
|
|
name=None,
|
|
pad=None,
|
|
showactive=None,
|
|
templateitemname=None,
|
|
type=None,
|
|
visible=None,
|
|
x=None,
|
|
xanchor=None,
|
|
y=None,
|
|
yanchor=None,
|
|
**kwargs,
|
|
):
|
|
"""
|
|
Construct a new Updatemenu object
|
|
|
|
Parameters
|
|
----------
|
|
arg
|
|
dict of properties compatible with this constructor or
|
|
an instance of
|
|
:class:`plotly.graph_objs.layout.Updatemenu`
|
|
active
|
|
Determines which button (by index starting from 0) is
|
|
considered active.
|
|
bgcolor
|
|
Sets the background color of the update menu buttons.
|
|
bordercolor
|
|
Sets the color of the border enclosing the update menu.
|
|
borderwidth
|
|
Sets the width (in px) of the border enclosing the
|
|
update menu.
|
|
buttons
|
|
A tuple of
|
|
:class:`plotly.graph_objects.layout.updatemenu.Button`
|
|
instances or dicts with compatible properties
|
|
buttondefaults
|
|
When used in a template (as
|
|
layout.template.layout.updatemenu.buttondefaults), sets
|
|
the default property values to use for elements of
|
|
layout.updatemenu.buttons
|
|
direction
|
|
Determines the direction in which the buttons are laid
|
|
out, whether in a dropdown menu or a row/column of
|
|
buttons. For `left` and `up`, the buttons will still
|
|
appear in left-to-right or top-to-bottom order
|
|
respectively.
|
|
font
|
|
Sets the font of the update menu button text.
|
|
name
|
|
When used in a template, named items are created in the
|
|
output figure in addition to any items the figure
|
|
already has in this array. You can modify these items
|
|
in the output figure by making your own item with
|
|
`templateitemname` matching this `name` alongside your
|
|
modifications (including `visible: false` or `enabled:
|
|
false` to hide it). Has no effect outside of a
|
|
template.
|
|
pad
|
|
Sets the padding around the buttons or dropdown menu.
|
|
showactive
|
|
Highlights active dropdown item or active button if
|
|
true.
|
|
templateitemname
|
|
Used to refer to a named item in this array in the
|
|
template. Named items from the template will be created
|
|
even without a matching item in the input figure, but
|
|
you can modify one by making an item with
|
|
`templateitemname` matching its `name`, alongside your
|
|
modifications (including `visible: false` or `enabled:
|
|
false` to hide it). If there is no template or no
|
|
matching item, this item will be hidden unless you
|
|
explicitly show it with `visible: true`.
|
|
type
|
|
Determines whether the buttons are accessible via a
|
|
dropdown menu or whether the buttons are stacked
|
|
horizontally or vertically
|
|
visible
|
|
Determines whether or not the update menu is visible.
|
|
x
|
|
Sets the x position (in normalized coordinates) of the
|
|
update menu.
|
|
xanchor
|
|
Sets the update menu's horizontal position anchor. This
|
|
anchor binds the `x` position to the "left", "center"
|
|
or "right" of the range selector.
|
|
y
|
|
Sets the y position (in normalized coordinates) of the
|
|
update menu.
|
|
yanchor
|
|
Sets the update menu's vertical position anchor This
|
|
anchor binds the `y` position to the "top", "middle" or
|
|
"bottom" of the range selector.
|
|
|
|
Returns
|
|
-------
|
|
Updatemenu
|
|
"""
|
|
super(Updatemenu, self).__init__("updatemenus")
|
|
|
|
if "_parent" in kwargs:
|
|
self._parent = kwargs["_parent"]
|
|
return
|
|
|
|
# Validate arg
|
|
# ------------
|
|
if arg is None:
|
|
arg = {}
|
|
elif isinstance(arg, self.__class__):
|
|
arg = arg.to_plotly_json()
|
|
elif isinstance(arg, dict):
|
|
arg = _copy.copy(arg)
|
|
else:
|
|
raise ValueError(
|
|
"""\
|
|
The first argument to the plotly.graph_objs.layout.Updatemenu
|
|
constructor must be a dict or
|
|
an instance of :class:`plotly.graph_objs.layout.Updatemenu`"""
|
|
)
|
|
|
|
# Handle skip_invalid
|
|
# -------------------
|
|
self._skip_invalid = kwargs.pop("skip_invalid", False)
|
|
self._validate = kwargs.pop("_validate", True)
|
|
|
|
# Populate data dict with properties
|
|
# ----------------------------------
|
|
_v = arg.pop("active", None)
|
|
_v = active if active is not None else _v
|
|
if _v is not None:
|
|
self["active"] = _v
|
|
_v = arg.pop("bgcolor", None)
|
|
_v = bgcolor if bgcolor is not None else _v
|
|
if _v is not None:
|
|
self["bgcolor"] = _v
|
|
_v = arg.pop("bordercolor", None)
|
|
_v = bordercolor if bordercolor is not None else _v
|
|
if _v is not None:
|
|
self["bordercolor"] = _v
|
|
_v = arg.pop("borderwidth", None)
|
|
_v = borderwidth if borderwidth is not None else _v
|
|
if _v is not None:
|
|
self["borderwidth"] = _v
|
|
_v = arg.pop("buttons", None)
|
|
_v = buttons if buttons is not None else _v
|
|
if _v is not None:
|
|
self["buttons"] = _v
|
|
_v = arg.pop("buttondefaults", None)
|
|
_v = buttondefaults if buttondefaults is not None else _v
|
|
if _v is not None:
|
|
self["buttondefaults"] = _v
|
|
_v = arg.pop("direction", None)
|
|
_v = direction if direction is not None else _v
|
|
if _v is not None:
|
|
self["direction"] = _v
|
|
_v = arg.pop("font", None)
|
|
_v = font if font is not None else _v
|
|
if _v is not None:
|
|
self["font"] = _v
|
|
_v = arg.pop("name", None)
|
|
_v = name if name is not None else _v
|
|
if _v is not None:
|
|
self["name"] = _v
|
|
_v = arg.pop("pad", None)
|
|
_v = pad if pad is not None else _v
|
|
if _v is not None:
|
|
self["pad"] = _v
|
|
_v = arg.pop("showactive", None)
|
|
_v = showactive if showactive is not None else _v
|
|
if _v is not None:
|
|
self["showactive"] = _v
|
|
_v = arg.pop("templateitemname", None)
|
|
_v = templateitemname if templateitemname is not None else _v
|
|
if _v is not None:
|
|
self["templateitemname"] = _v
|
|
_v = arg.pop("type", None)
|
|
_v = type if type is not None else _v
|
|
if _v is not None:
|
|
self["type"] = _v
|
|
_v = arg.pop("visible", None)
|
|
_v = visible if visible is not None else _v
|
|
if _v is not None:
|
|
self["visible"] = _v
|
|
_v = arg.pop("x", None)
|
|
_v = x if x is not None else _v
|
|
if _v is not None:
|
|
self["x"] = _v
|
|
_v = arg.pop("xanchor", None)
|
|
_v = xanchor if xanchor is not None else _v
|
|
if _v is not None:
|
|
self["xanchor"] = _v
|
|
_v = arg.pop("y", None)
|
|
_v = y if y is not None else _v
|
|
if _v is not None:
|
|
self["y"] = _v
|
|
_v = arg.pop("yanchor", None)
|
|
_v = yanchor if yanchor is not None else _v
|
|
if _v is not None:
|
|
self["yanchor"] = _v
|
|
|
|
# Process unknown kwargs
|
|
# ----------------------
|
|
self._process_kwargs(**dict(arg, **kwargs))
|
|
|
|
# Reset skip_invalid
|
|
# ------------------
|
|
self._skip_invalid = False
|