pub struct Funnel<'a> { /* private fields */ }
Expand description
Visualize stages in a process using length-encoded bars. This trace can be used to show data in either a part-to-whole representation wherein each item appears in a single stage, or in a “drop-off” representation wherein each item appears in each stage it traversed. See also the “funnelarea” trace type for a different approach to visualizing funnel data.
Implementations§
Source§impl<'a> Funnel<'a>
impl<'a> Funnel<'a>
Sourcepub fn visible(&mut self, visible: Visible) -> &mut Self
pub fn visible(&mut self, visible: Visible) -> &mut Self
Determines whether or not this trace is visible. If legendonly, the trace is not drawn, but can appear as a legend item (provided that the legend itself is visible).
default: true
Sourcepub fn showlegend(&mut self, showlegend: bool) -> &mut Self
pub fn showlegend(&mut self, showlegend: bool) -> &mut Self
Determines whether or not an item corresponding to this trace is shown in the legend.
default: true
Sourcepub fn legendgroup(&mut self, legendgroup: &'a str) -> &mut Self
pub fn legendgroup(&mut self, legendgroup: &'a str) -> &mut Self
Sets the legend group for this trace. Traces part of the same legend group hide/show at the same time when toggling legend items.
default: ``
Sourcepub fn name(&mut self, name: &'a str) -> &mut Self
pub fn name(&mut self, name: &'a str) -> &mut Self
Sets the trace name. The trace name appear as the legend item and on hover.
Sourcepub fn uid(&mut self, uid: &'a str) -> &mut Self
pub fn uid(&mut self, uid: &'a str) -> &mut Self
Assign an id to this trace, Use this to provide object constancy between traces during animations and transitions.
Sourcepub fn ids(&mut self, ids: &'a [&'a str]) -> &mut Self
pub fn ids(&mut self, ids: &'a [&'a str]) -> &mut Self
Assigns id labels to each datum. These ids for object constancy of data points during animation. Should be an array of strings, not numbers or any other type.
Sourcepub fn meta(&mut self, meta: Any) -> &mut Self
pub fn meta(&mut self, meta: Any) -> &mut Self
Assigns extra meta information associated with this trace that can be used in various text attributes. Attributes such as trace name
, graph, axis and colorbar title.text
, annotation text
rangeselector
, updatemenues
and sliders
label
text all support meta
. To access the trace meta
values in an attribute in the same trace, simply use %{meta[i]}
where i
is the index or key of the meta
item in question. To access trace meta
in layout attributes, use %{data[n[.meta[i]}
where i
is the index or key of the meta
and n
is the trace index.
Sourcepub fn selectedpoints(&mut self, selectedpoints: Any) -> &mut Self
pub fn selectedpoints(&mut self, selectedpoints: Any) -> &mut Self
Array containing integer indices of selected points. Has an effect only for traces that support selections. Note that an empty array means an empty selection where the unselected
are turned on for all points, whereas, any other non-array values means no selection all where the selected
and unselected
styles have no effect.
pub fn hoverlabel(&mut self) -> &mut Hoverlabel<'a>
pub fn stream(&mut self) -> &mut Stream<'a>
Sourcepub fn uirevision(&mut self, uirevision: Any) -> &mut Self
pub fn uirevision(&mut self, uirevision: Any) -> &mut Self
Controls persistence of some user-driven changes to the trace: constraintrange
in parcoords
traces, as well as some editable: true
modifications such as name
and colorbar.title
. Defaults to layout.uirevision
. Note that other user-driven trace attribute changes are controlled by layout
attributes: trace.visible
is controlled by layout.legend.uirevision
, selectedpoints
is controlled by layout.selectionrevision
, and colorbar.(x|y)
(accessible with config: {editable: true}
) is controlled by layout.editrevision
. Trace changes are tracked by uid
, which only falls back on trace index if no uid
is provided. So if your app can add/remove traces before the end of the data
array, such that the same trace has a different index, you can still preserve user-driven changes if you give each trace a uid
that stays with it as it moves.
Sourcepub fn x_0(&mut self, x_0: Any) -> &mut Self
pub fn x_0(&mut self, x_0: Any) -> &mut Self
Alternate to x
. Builds a linear space of x coordinates. Use with dx
where x0
is the starting coordinate and dx
the step.
default: 0
Sourcepub fn dx(&mut self, dx: f64) -> &mut Self
pub fn dx(&mut self, dx: f64) -> &mut Self
Sets the x coordinate step. See x0
for more info.
default: 1
Sourcepub fn y_0(&mut self, y_0: Any) -> &mut Self
pub fn y_0(&mut self, y_0: Any) -> &mut Self
Alternate to y
. Builds a linear space of y coordinates. Use with dy
where y0
is the starting coordinate and dy
the step.
default: 0
Sourcepub fn dy(&mut self, dy: f64) -> &mut Self
pub fn dy(&mut self, dy: f64) -> &mut Self
Sets the y coordinate step. See y0
for more info.
default: 1
Sourcepub fn hovertext(&mut self, hovertext: &'a str) -> &mut Self
pub fn hovertext(&mut self, hovertext: &'a str) -> &mut Self
Sets hover text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace’s (x,y) coordinates. To be seen, trace hoverinfo
must contain a text flag.
default: ``
Sourcepub fn hovertemplate(&mut self, hovertemplate: &'a str) -> &mut Self
pub fn hovertemplate(&mut self, hovertemplate: &'a str) -> &mut Self
Template string used for rendering the information that appear on hover box. Note that this will override hoverinfo
. Variables are inserted using %{variable}, for example “y: %{y}”. Numbers are formatted using d3-format’s syntax %{variable:d3-format}, for example “Price: %{y:$.2f}”. https://github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#d3_format for details on the formatting syntax. Dates are formatted using d3-time-format’s syntax %{variable|d3-time-format}, for example “Day: %{2019-01-01|%A}”. https://github.com/d3/d3-3.x-api-reference/blob/master/Time-Formatting.md#format for details on the date formatting syntax. The variables available in hovertemplate
are the ones emitted as event data described at this link https://plotly.com/javascript/plotlyjs-events/#event-data. Additionally, every attributes that can be specified per-point (the ones that are arrayOk: true
) are available. variables percentInitial
, percentPrevious
and percentTotal
. Anything contained in tag <extra>
is displayed in the secondary box, for example “<extra></extra>
.
default: ``
Sourcepub fn hoverinfo(&mut self) -> &mut Hoverinfo
pub fn hoverinfo(&mut self) -> &mut Hoverinfo
Determines which trace information appear on hover. If none
or skip
are set, no information is displayed upon hovering. But, if none
is set, click and hover events are still fired.
default: all
Sourcepub fn textinfo(&mut self) -> &mut Textinfo
pub fn textinfo(&mut self) -> &mut Textinfo
Determines which trace information appear on the graph. In the case of having multiple funnels, percentages & totals are computed separately (per trace).
Sourcepub fn texttemplate(&mut self, texttemplate: &'a str) -> &mut Self
pub fn texttemplate(&mut self, texttemplate: &'a str) -> &mut Self
Template string used for rendering the information text that appear on points. Note that this will override textinfo
. Variables are inserted using %{variable}, for example “y: %{y}”. Numbers are formatted using d3-format’s syntax %{variable:d3-format}, for example “Price: %{y:$.2f}”. https://github.com/d3/d3-3.x-api-reference/blob/master/Formatting.md#d3_format for details on the formatting syntax. Dates are formatted using d3-time-format’s syntax %{variable|d3-time-format}, for example “Day: %{2019-01-01|%A}”. https://github.com/d3/d3-3.x-api-reference/blob/master/Time-Formatting.md#format for details on the date formatting syntax. Every attributes that can be specified per-point (the ones that are arrayOk: true
) are available. variables percentInitial
, percentPrevious
, percentTotal
, label
and value
.
default: ``
Sourcepub fn text(&mut self, text: &'a str) -> &mut Self
pub fn text(&mut self, text: &'a str) -> &mut Self
Sets text elements associated with each (x,y) pair. If a single string, the same string appears over all the data points. If an array of string, the items are mapped in order to the this trace’s (x,y) coordinates. If trace hoverinfo
contains a text flag and hovertext is not set, these elements will be seen in the hover labels.
default: ``
Sourcepub fn textposition(&mut self, textposition: Textposition) -> &mut Self
pub fn textposition(&mut self, textposition: Textposition) -> &mut Self
Specifies the location of the text
. inside positions text
inside, next to the bar end (rotated and scaled if needed). outside positions text
outside, next to the bar end (scaled if needed), unless there is another bar stacked on this one, then the text gets pushed inside. auto tries to position text
inside the bar, but if the bar is too small and no bar is stacked on this one the text is moved outside.
default: auto
Sourcepub fn insidetextanchor(
&mut self,
insidetextanchor: Insidetextanchor,
) -> &mut Self
pub fn insidetextanchor( &mut self, insidetextanchor: Insidetextanchor, ) -> &mut Self
Determines if texts are kept at center or start/end points in textposition
inside mode.
default: middle
Sourcepub fn textangle(&mut self, textangle: Angle) -> &mut Self
pub fn textangle(&mut self, textangle: Angle) -> &mut Self
Sets the angle of the tick labels with respect to the bar. For example, a tickangle
of -90 draws the tick labels vertically. With auto the texts may automatically be rotated to fit with the maximum size in bars.
default: 0
Sourcepub fn insidetextfont(&mut self) -> &mut Insidetextfont<'a>
pub fn insidetextfont(&mut self) -> &mut Insidetextfont<'a>
Sets the font used for text
lying inside the bar.
Sourcepub fn outsidetextfont(&mut self) -> &mut Outsidetextfont<'a>
pub fn outsidetextfont(&mut self) -> &mut Outsidetextfont<'a>
Sets the font used for text
lying outside the bar.
Sourcepub fn constraintext(&mut self, constraintext: Constraintext) -> &mut Self
pub fn constraintext(&mut self, constraintext: Constraintext) -> &mut Self
Constrain the size of text inside or outside a bar to be no larger than the bar itself.
default: both
Sourcepub fn cliponaxis(&mut self, cliponaxis: bool) -> &mut Self
pub fn cliponaxis(&mut self, cliponaxis: bool) -> &mut Self
Determines whether the text nodes are clipped about the subplot axes. To show the text nodes above axis lines and tick labels, make sure to set xaxis.layer
and yaxis.layer
to below traces.
default: true
Sourcepub fn orientation(&mut self, orientation: Orientation) -> &mut Self
pub fn orientation(&mut self, orientation: Orientation) -> &mut Self
Sets the orientation of the funnels. With v (h), the value of the each bar spans along the vertical (horizontal). By default funnels are tend to be oriented horizontally; unless only y array is presented or orientation is set to v. Also regarding graphs including only ‘horizontal’ funnels, autorange on the y-axis are set to reversed.
Sourcepub fn offset(&mut self, offset: f64) -> &mut Self
pub fn offset(&mut self, offset: f64) -> &mut Self
Shifts the position where the bar is drawn (in position axis units). In group barmode, traces that set offset will be excluded and drawn in overlay mode instead.
default: null
Sourcepub fn width(&mut self, width: f64) -> &mut Self
pub fn width(&mut self, width: f64) -> &mut Self
Sets the bar width (in position axis units).
default: null
pub fn marker(&mut self) -> &mut Marker<'a>
pub fn connector(&mut self) -> &mut Connector<'a>
Sourcepub fn offsetgroup(&mut self, offsetgroup: &'a str) -> &mut Self
pub fn offsetgroup(&mut self, offsetgroup: &'a str) -> &mut Self
Set several traces linked to the same position axis or matching axes to the same offsetgroup where bars of the same position coordinate will line up.
default: ``
Sourcepub fn alignmentgroup(&mut self, alignmentgroup: &'a str) -> &mut Self
pub fn alignmentgroup(&mut self, alignmentgroup: &'a str) -> &mut Self
Set several traces linked to the same position axis or matching axes to the same alignmentgroup. This controls whether bars compute their positional range dependently or independently.
default: ``
Sourcepub fn xaxis(&mut self, xaxis: &'a str) -> &mut Self
pub fn xaxis(&mut self, xaxis: &'a str) -> &mut Self
Sets a reference between this trace’s x coordinates and a 2D cartesian x axis. If x (the default value), the x coordinates refer to layout.xaxis
. If x2, the x coordinates refer to layout.xaxis2
, and so on.
default: x
Sourcepub fn yaxis(&mut self, yaxis: &'a str) -> &mut Self
pub fn yaxis(&mut self, yaxis: &'a str) -> &mut Self
Sets a reference between this trace’s y coordinates and a 2D cartesian y axis. If y (the default value), the y coordinates refer to layout.yaxis
. If y2, the y coordinates refer to layout.yaxis2
, and so on.
default: y
Sourcepub fn idssrc(&mut self, idssrc: &'a str) -> &mut Self
pub fn idssrc(&mut self, idssrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for ids .
Sourcepub fn customdatasrc(&mut self, customdatasrc: &'a str) -> &mut Self
pub fn customdatasrc(&mut self, customdatasrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for customdata .
Sourcepub fn metasrc(&mut self, metasrc: &'a str) -> &mut Self
pub fn metasrc(&mut self, metasrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for meta .
Sourcepub fn xsrc(&mut self, xsrc: &'a str) -> &mut Self
pub fn xsrc(&mut self, xsrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for x .
Sourcepub fn ysrc(&mut self, ysrc: &'a str) -> &mut Self
pub fn ysrc(&mut self, ysrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for y .
Sourcepub fn hovertextsrc(&mut self, hovertextsrc: &'a str) -> &mut Self
pub fn hovertextsrc(&mut self, hovertextsrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for hovertext .
Sourcepub fn hovertemplatesrc(&mut self, hovertemplatesrc: &'a str) -> &mut Self
pub fn hovertemplatesrc(&mut self, hovertemplatesrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for hovertemplate .
Sourcepub fn hoverinfosrc(&mut self, hoverinfosrc: &'a str) -> &mut Self
pub fn hoverinfosrc(&mut self, hoverinfosrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for hoverinfo .
Sourcepub fn texttemplatesrc(&mut self, texttemplatesrc: &'a str) -> &mut Self
pub fn texttemplatesrc(&mut self, texttemplatesrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for texttemplate .
Sourcepub fn textsrc(&mut self, textsrc: &'a str) -> &mut Self
pub fn textsrc(&mut self, textsrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for text .
Sourcepub fn textpositionsrc(&mut self, textpositionsrc: &'a str) -> &mut Self
pub fn textpositionsrc(&mut self, textpositionsrc: &'a str) -> &mut Self
Sets the source reference on Chart Studio Cloud for textposition .