Plots a List<Float> as a trend line: smooth horizontally-clamped cubic curves (no vertical overshoot) or straight segments, a gradient area fill, optional point markers and x labels, and a leading-edge sweep entry animation; degenerate data (empty, single point, flat series) renders gracefully.
ParameterTypeDefaultDescription
valuesrequiredTypeList<Float>DefaultrequiredDescriptionthe series to plot, in order, spread evenly across the width. Values must be finite (negative values are allowed). An empty list renders an empty (but described) chart area.
modifierTypeModifierDefaultModifierDescriptionthe Modifier applied to the chart (it fills the available width at a minimum height of FormaChartDefaults.MinChartHeight).
lineColorTypeColorDefaultColor.UnspecifiedDescriptionthe color of the line, its points, and the area fill (defaults to the theme's primary).
strokeWidthTypeDpDefaultFormaChartDefaults.LineStrokeWidthDescriptionthe thickness of the line (defaults to 2dp).
minValueTypeFloat?DefaultnullDescriptionthe value the y-axis bottoms out at. When null, the data's own minimum is used. Must be finite when supplied; values below it are clipped to the plot's bottom edge.
maxValueTypeFloat?DefaultnullDescriptionthe value the y-axis tops out at. When null, the data's own maximum is used. Must be finite (and greater than minValue when both are supplied); values above it are clipped to the plot's top edge.
smoothTypeBooleanDefaulttrueDescriptionwhether segments are smoothed cubic curves or straight polyline segments. Smoothing clamps control points horizontally to the midpoint between neighboring x positions, so the curve never overshoots a value vertically.
fillAreaTypeBooleanDefaulttrueDescriptionwhether to fill the area under the line with a vertical gradient of lineColor fading to transparent at the plot floor.
showPointsTypeBooleanDefaultfalseDescriptionwhether to draw a FormaChartDefaults.LinePointRadius circle marker at each data point. A single-value dataset always draws its point (there is no segment to draw).
showGridLinesTypeBooleanDefaulttrueDescriptionwhether to draw horizontal gridlines dividing the plot into FormaChartDefaults.GridLineCount bands, in FormaChartDefaults.gridLineColor.
xLabelsTypeList<String>DefaultemptyList()Descriptionoptional x-axis labels drawn under the plot in FormaChartDefaults.axisLabelStyle, paired index-by-index with values and centered under their points; labels beyond the point count are ignored. Empty reserves no label band.
valueFormatterType(Float) -> StringDefaultFormaChartDefaults.ValueFormatterDescriptionformats a value for the auto-generated accessibility summary.
animationSpecTypeFiniteAnimationSpec<Float>?DefaultFormaChartDefaults.EntryAnimationSpecDescriptionthe entry animation for the leading-edge sweep, or null to render a static final frame.
contentDescriptionTypeString?DefaultnullDescriptionan explicit accessibility description; when null a summary of the data is generated automatically.