Skip to content

Interface: AreaOptions ​

Options of area.

Extends ​

  • Omit<LineOptions, "lineDash" | "lineDashSequence" | "lineDashMap">

Properties ​

PropertyModifierTypeDescriptionInherited from
agg?readonlyAggFunctionAggregate the rows of each line that share an x (y when horizontal): 'sum', 'avg', 'count', 'min', 'max', 'median' or a function of the values — one point per position, in order of first appearance. A Holochart extension (px.line draws every row).LineOptions.agg
animationFrame?readonlyColumnRefColumn of frame values: one frame per value (in categoryOrders / first-appearance order), with a Play / Pause update menu and a slider. Axis ranges are fixed across frames.AnimationFrameOptions.animationFrame
animationGroup?readonlyColumnRefColumn matching rows across frames (ids), so each object moves rather than being replaced.AnimationFrameOptions.animationGroup
categoryOrders?readonlyReadonly<Record<string, readonly unknown[]>>Value orders per column: { day: ['Thu', 'Fri', 'Sat', 'Sun'] }. They order the traces and legend (for grouping columns), facets, frames and category axes. Values not listed follow in order of first appearance; listed values without rows still take a color and a facet (as px).CommonOptions.categoryOrders
color?readonlyColumnRefColumn to color by.DiscreteColorOptions.color
colorDiscreteMap?readonlyReadonly<Record<string, string>> | "identity"Fixed colors per value of color ({ Asia: 'red' }); other values continue with the sequence. 'identity': the values are colors themselves (no legend entries for them).DiscreteColorOptions.colorDiscreteMap
colorDiscreteSequence?readonlyreadonly string[]Colors for the values of color, in order. Default: the template's colorway.DiscreteColorOptions.colorDiscreteSequence
customData?readonlyreadonly ColumnRef[]Columns put in customdata (first, before hoverData's), e.g. for click handlers.HoverOptions.customData
errorX?readonlyColumnRefColumn of x error sizes (error_x.array).ErrorBarOptions.errorX
errorXMinus?readonlyColumnRefColumn of x error sizes below (error_x.arrayminus).ErrorBarOptions.errorXMinus
errorY?readonlyColumnRefColumn of y error sizes (error_y.array).ErrorBarOptions.errorY
errorYMinus?readonlyColumnRefColumn of y error sizes below (error_y.arrayminus).ErrorBarOptions.errorYMinus
facetCol?readonlyColumnRefColumn whose values make the columns of subplots.FacetOptions.facetCol
facetColSpacing?readonlynumberSpace between facet columns, as a fraction of the plot width. Default 0.02.FacetOptions.facetColSpacing
facetColWrap?readonlynumberWrap facetCol after this many columns (row by row from the top). Ignored with facetRow or a marginal. Default 0 (no wrapping).FacetOptions.facetColWrap
facetRow?readonlyColumnRefColumn whose values make the rows of subplots (first value at the top).FacetOptions.facetRow
facetRowSpacing?readonlynumberSpace between facet rows, as a fraction of the plot height. Default 0.03 (0.07 wrapped).FacetOptions.facetRowSpacing
groupnorm?readonly"percent" | "fraction"Normalize the stacks: 'fraction' or 'percent' of each x's total.-
height?readonlynumberFigure height in px (layout.height).CommonOptions.height
hoverData?readonly| readonly ColumnRef[] | Readonly<Record<string, string | boolean>>More columns for the hover label, through customdata: a list of columns, or an object that adds columns (true), removes lines (false, e.g. { x: false }) or formats them (':.2f', `'%Y'`).
hoverName?readonlyColumnRefColumn shown in bold at the top of the hover label (hovertext).HoverOptions.hoverName
labels?readonlyReadonly<Record<string, string>>Display names of columns: { gdpPercap: 'GDP per capita' }. Used for axis titles, hover lines, the legend title, facet labels, the colorbar title and the animation slider.CommonOptions.labels
lineGroup?readonlyColumnRefColumn splitting lines within a color group (one line per value, same color and legend item).LineOptions.lineGroup
lineShape?readonlystringline.shape: 'linear' (default), 'spline', 'hv', 'vh', 'hvh', 'vhv'.LineOptions.lineShape
logX?readonlybooleanLog x axis (type: 'log', on every facet).AxisOptions.logX
logY?readonlybooleanLog y axis.AxisOptions.logY
markers?readonlybooleanShow markers at the points.LineOptions.markers
orientation?readonly"v" | "h"'v' or 'h'. Default as px: 'h' when only the value column of a horizontal chart is given or when x is numeric and y is not, else 'v'.XYOptions.orientation
rangeX?readonlyreadonly [unknown, unknown]Fixed x range, in data units (log axes take data units too, as px).AxisOptions.rangeX
rangeY?readonlyreadonly [unknown, unknown]Fixed y range, in data units.AxisOptions.rangeY
symbol?readonlyColumnRefColumn whose values get different marker symbols (one trace per value).SymbolOptions.symbol
symbolMap?readonlyReadonly<Record<string, string>> | "identity"Fixed symbols per value; 'identity': the values are symbols.SymbolOptions.symbolMap
symbolSequence?readonlyreadonly string[]Symbols in order. Default: the template's scatter symbols, else circle, diamond, square, x, cross.SymbolOptions.symbolSequence
template?readonlystring | Templatelayout.template: a registered name ('plotly-classic') or a template object. Default: unset, so the chart's default template applies (Holochart's holochart look); its colorway, symbol and dash cycles and sequential colorscale are what the figure's colors are taken from.CommonOptions.template
text?readonlyColumnRefColumn of text drawn at the points.LineOptions.text
title?readonlystringFigure title (layout.title.text).CommonOptions.title
width?readonlynumberFigure width in px (layout.width).CommonOptions.width
x?readonlyColumnRefColumn of x values.XYOptions.x
y?readonlyColumnRefColumn of y values.XYOptions.y

Released under the MIT License.