--- title: "Perspective - Line" description: "The Line chart component is Perspective's primary tool for visualizing time-series and continuous data." --- # Perspective - Line > The Line chart component is Perspective's primary tool for visualizing time-series and continuous data. ![The default display for the Line component.](imgs/perspective-line-chart.png) **Component Palette Icon:** ![The Line component palette icon within the Perspective Components panel.](imgs/perspective-line-icon.png) The Line chart component is Perspective's primary tool for visualizing time-series and continuous data. Each pen (an individual data series) is independently bound to a data field and independently styled. Multiple pens can coexist on the same chart, share or split y-axes, and be configured with entirely different visual behaviors without any coupling between them. The Line chart component has two pre-configured variants: * **Basic**: The foundational time-series chart. Use this variant to plot one or more pens against a time or value axis. * **Conditional**: A time-series chart where the stroke color and visibility of each series segment is driven by threshold rules. ## Properties Most Properties have binding options. For more information on Bindings, see [Types of Bindings in Perspective](ignition-modules\perspective\working-with-perspective-components\bindings-in-perspective\bindings-in-perspective.md). This section only documents the Props Category of properties. The other Categories are described on the [Perspective Component Properties](ignition-modules\perspective\working-with-perspective-components\perspective-component-properties.md) page. | Name | Description | Property Type | | ---- | ----------- | ------------- | | data | Dataset powering the chart. Each object (row) is one point along the x-axis, and each series reads its own value from a named field on that row. `null` draws a gap rather than a point. Set `advanced.connectNulls` on a series to bridge it instead. | array | | series | A set of related data points. One object per pen. Each series is fully independent. See [series Properties](#series-properties) for more array properties. | array | | stackGroups | A series in the same group to stack on top of one another. Stacked in the order declared, not in the order listed in this array. Leave empty to draw every series on its own. | array | | xAxis | Configuration and styling options for the horizontal axis. See [xAxis Properties](#xaxis-properties) for more object properties. | object | | yAxis | Configuration and styling options for the vertical axis. Index `0` is the primary axis. Additional entries enable dual axis layouts. See [yAxis Properties](#yaxis-properties) for more array properties. | array | | title | Chart title and subtitle. See [title Properties](#title-properties) for more object properties. | object | | legend | Configures how the chart legend displays.**visible**: Shows the legend when true. Default is true. Value is boolean.**position**: Placement of the legend within the chart. Value is string.**orientation**: Layout direction of legend items. Can be `horizontal` or `vertical`. Value is string.**interactive**: Clicking a legend item toggles the visibility of that series when true. Default is true. Value is boolean.**color**: Legend item text color. This value takes precedence over `elementStyle.color` when both are set. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Legend item text size. This value takes precedence over `elementStyle.fontSize` when both are set. Value is number.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | | visualMap | Global conditional styling rules applied across all series. When enabled, overrides each series' `line.color` and `line.type` based on where the value falls within the defined threshold ranges. Applicable to the Conditional Line chart variant. See [visualMap Properties](#visualmap-properties) for more object properties. | object | | zoom | Zoom and pan behavior. Allows users to zoom along the x-axis, y-axis, or both.**enabled**: Scroll and drag zoom functionalities are enabled when true. Default is false. Value is boolean.**type**: The type of zoom to apply. Value is string.`slider` renders a visible scroll bar.`inside` enables scroll-wheel and drag zoom with no visible slider.`both` enables both the slider and drag zoom functionalities.**axis**: Controls which axis the zoom applies to. Can be `x`, `y`, or `both`. Value is string.**xPosition**: Position of the x-axis zoom slider when enabled. Can be `top` or `bottom`. Value is string.**yPosition**: Position of the y-axis zoom slider when enabled. Can be `left` or `right`. Value is string.**height**: The x-axis slider height in pixels. Applies when `zoom.axis` is `x` or `both`. Value is number.**width**: The y-axis slider width in pixels. Applies when `zoom.axis` is `y` or `both`. Value is number.**backgroundColor**: Background color of the slider track. Leave empty to use the chart theme default. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx). | object | | tooltip | The tooltip text shown on hover. Can be overriden by `series.advanced.tooltip`.**enabled**: Shows the tooltip on hover for all pens when true. If false, no individual pen setting will be able to display the tooltip unless this value is set to true again. Default is true. Value is boolean.**trigger**: Configures the way tooltips are displayed. Note to set this value first before modifying `tooltip.formatter`, since this value determines what `tooltip.formatter`, and each pen's own override, will do. Value is string.`axis` shows one tooltip for every pen at the hovered x-axis value.`item` shows a separate tooltip for the hovered point.**formatter**: Configures how the tooltip text is built. Applies to each pen, but does not override `series.advanced.tooltip` if set.**type**: The type of formatting to apply to the tooltip. `value` reformats the numbers inside the default tooltip. `template` replaces the whole default tooltip with your text. Value is string.**value**: The formatting to apply to each value, keeping the default tooltip layout. Must contain the `{value}` key. Any text without `{value}` replaces the number. Value is string. | object | | axisPointer | The line or crosshair that follows the hovered point along the axes, and the label it can print along the axes. See [axisPointer Properties](#axispointer-properties) for more object properties. | object | | appearance | Visual configuration of the chart. Series-level properties take precedence when overlap occurs. See [appearance Properties](#appearance-properties) for more object properties. | object | | style | Style configuration for the chart. | object | ### series Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | label | The series display name. The label is visible in the legend and tooltips. | string | | value | Field key from `data` to plot on the y-axis. | string | | line | Configures the line stroke for the series.**type:** The line pattern. Can be `solid`, `dashed`, or `dotted`. Value is string.**width:** Line stroke width in pixels. Value is number. | object | | smooth | The segment interpolation is curved when true. If false, the interpolation is rigid. | boolean | | points | Configures the data point dot(s) shown at each value, including styling.**visible**: Renders a dot for each data point and enables formatting for those dots when true. Default is true. Value is boolean.**size**: Radius of data point dots in pixels. Value is number.**fillColor**: Dot fill color. Defaults to the series color. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**outlineColor**: Stroke color of the point outline. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**outlineWidth**: Stroke width of the point outline in pixels. Value is number.**shape**: Shape of the data point dot. Value is string. | object | | dataLabels | The value label randered at each data point.**visible**: Shows the value label rendered at each data point when true. Default is false. Value is boolean.**position**: Position of the labels relative to data points. Value is string.**format**: Format expression for the displayed value, rendering once per data point. Token options include `{series}`, `{value}` (y-axis value), `{category}` (x-axis value), and `{dimension:}`. Value is string.**color**: Color of the data label text. Takes precedence over `elementStyle.color` when set. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the data label text. Takes precedence over `elementStyle.font` when set. Value is number.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | | visible | Shows the pen without removing it when true. Default is true. | boolean | | referenceLines | Renders reference lines at threshold boundaries. This offers a persistent visual indicator of where value transitions occur, independent of the current data. See the [series.referenceLines Properties](#seriesreferencelines-properties) section for more object properties. | object | | advanced | Configures less commonly used series settings. See the [series.advanced Properties](#seriesadvanced-properties) section for more object properties. | object | #### series.referenceLines Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | animation | Configures reference line entry and transition animations.**enabled**: Enables the animation of reference lines on render and update when true. Default is true. Value is boolean.**entry**: Initial animation applied when the reference lines first render.**duration**: Entry animation duration in milliseconds. Value is number.**easing**: Easing function applied to the entry animation. Value is string.**delay**: Delay before the entry animation starts, in milliseconds. Value is number.**transition**: Update animation applied when the reference lines change.**duration**: Transition animation duration in milliseconds. Value is number.**easing**: Easing function applied to the transaction animation. Value is string.**delay**: Delay before the transition animation starts, in milliseconds. Value is number. | object | | endpoints | Configures the dots drawn at the two ends of a reference line, including styling.**visible**: Renders a dot at each end of every refence line on the chart when true. If false, both ends are hidden regardless of the points configured. Default is true. Value is boolean.**points**: Styling for the end dots on a reference line. Provide one entry to share styling across both points, or two entries to style the start and end points independently.**size**: Radius of the endpoint symbol in pixels. Value is number.**shape**: Shape of the endpoint symbol. Accepts a built-in name, `image://url`, `image://data:image/...` base64 URI, or `path://` SVG path. Value is string. | object | | items | Ordered list of reference lines. | array | #### series.advanced Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | yAxis | Enables dual-axis layouts, and determines which y-axis the series binds to. | number | | connectNulls | Connects the line across null or missing values when true. Default is false. | boolean | | step | Render as a step line at the `start`, `middle`, or `end`. Leave empty to disable step rendering. | string | | tooltip | Tooltip text settings for a single pen. When `tooltip.trigger` is set to `item`, all settings under this property will apply to the single pen tooltip. When set to `axis`, every pen along the axis shares one tooltip, so `enabled` and `formatter` will only apply to this row.**enabled**: Shows the pen in the tooltip when true. When `tooltip.trigger` is `axis`, false drops the pen row. When `tooltip.trigger` is `item`, false displays no tooltip on hover. Value is boolean.**formatter**: An expression used to format the displayed value for the tooltip, replacing chart-level settings. Leave empty to keep chart-level settings.**type**: The format type of the expression. `value` reformats the numbers inside the default tooltip. `template` replaces the pen's text with your own. Value is string.**value**: Applied to each of the pen's values, keeping the default row layout. When `value` is selected as the `formatter.type`, default dropdown options include `%`, `kW`, and `°F`. However, any unit can be entered before or after `{value}` by typing directly into the field for either type selection. Leave empty to use the chart-level setting. Value is string. | object | ### xAxis Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | type | Axis scale type. Set to `value` to enable function (x,y) plotting. | string | | field | Default x-axis field for all series. Can be overridden per series via `series` configuration. | string | | visible | Shows the x-axis on the chart when true. Default is true. | boolean | | position | Side of the chart the x-axis renders on. | string | | title | Configures the x-axis title.**visible**: Shows the x-axis title when true. Default is true. Value is boolean.**text**: Axis title text. Leave empty for no title. Value is string.**color**: Color of the axis title text. Leave empty to use the theme's label color. This value takes precedence over the `elementStyle.color` property. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the axis title text. Takes precedence over the `elementStyle.fontSize` property. Value is number. **position**: Where the title sits along the axis. Defaults to the center. Value is string.**gap**: Distance in pixels between the axis title and the axis line. Value is number.**rotation**: Axis title rotation in degrees. Value is number.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | | min | The start value, or minimum boundary, of the x-axis. Accepts `number`, `string`, or `auto`. | string | | max | The end value, or maximum boundary, of the x-axis. Accepts `number`, `string`, or `auto`. | string | | boundaryGap | Configures axis spacing at the data extremes. The categories will be inset from the edges of the axis when true.For the `category` axis type, true places gaps at both edges.For the `time` and `value` axis types, true places a gap at the end only. | boolean | | gridLines | Vertical grid line stroke configuration and styling.**visible**: Shows vertical grid lines when true. Default is false. Value is boolean.**color**: Color of the vertical gridlines. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx). | object | | axisLine | Axis line stroke configuration and styling.**visible**: Shows the axis line stroke when true. Ticks and labels remain visible independently. Default is true. Value is boolean.**color**: Color of the axis line stroke. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx). | object | | ticks | Configures the tick marks along the x-axis.**visible**: Shows tick marks along the axis when true. Default is true. Value is boolean.**displayInside**: Renders tick marks on the inside of the axis line when true. Default is false. Value is boolean.**majorSplit**: The number of value-axis tick intervals. `auto` sets to the recommended value. The final count may adjust for readability, and has no effect on `category` axis types. Value is string.**minorSplit**: Number of minor tick intervals between two adjacent major ticks. Omit or set to `0` to hide. Value is number. | object | | labels | Configures tick label text.**visible**: Shows tick label text when true. Default is true. Value is boolean.**color**: Color of the tick label text. Takes precedence over the `elementStyle.color` property. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the tick label text. Takes precedence over the `elementStyle.fontSize` property. Value is number.**rotation**: Tick label rotation in degrees. Value is number.**width**: Max width in pixels before overflow handling activates. Value is number.**overflow**: Handles labels wider than the specified `width` value. Options include `none`, `truncate`, `break`, and `breakAll`. Value is string.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | | advanced | Advanced optional settings for the x-axis. See the [xAxis.advanced Properties](#xaxisadvanced-properties) section for object properties. | object | #### xAxis.advanced Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | axisPointer | Configures axis pointer settings for the x-axis alone. Only the x-axis shows a pointer, unless the chart-level shape is cross, which adds one on the y-axis as well. Turning the pointer off at the chart level will turn it off here as well. **enabled**: Displays a pointer on the axis. `auto` follows the chart-level axis pointer. Leaving this value blank removes the pointer from the axis, while other axes keep their pointers. Tooltips will still display. Value is string.**type**: Pointer shape for the axis, giving each axis its own cross pointer shape. Options include `auto`, `shadow`, `line`, and `none`. `shadow` requires the `category` axis type, and will shrink to a single pixel for `value` or `time` axis types. Value is string.**label**: The pointer's label text on the axis.**visible**: Displays the pointer label. Use this property to hide a cross pointer's y-axis label, which reports where the cursor is rather than a point's value. Default is `auto`. Value is string.**color**: Color of the label. Leave empty to follow the chart-level color. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the label. Empty follows the chart-level size. Value is number.**backgroundColor**: Background color of the label box. Empty follows the chart-level color. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | ### yAxis Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | visible | Shows the y-axis on the chart when true. Default is true. | boolean | | title | Configures the y-axis title.**visible**: Shows the y-axis title when true. Default is true. Value is boolean.**text**: Axis title text. Leave empty for no title. Value is string.**color**: Color of the axis title text. Leave empty to use the theme's label color. This value takes precedence over the `elementStyle.color` property. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the axis title text. Takes precedence over the `elementStyle.fontSize` property. Value is number. **position**: Where the title sits along the axis. Defaults to the middle. Value is string.**gap**: Distance in pixels between the axis title and the axis line. Value is number.**rotation**: Axis title rotation in degrees. Value is number.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | | min | The start value, or minimum boundary, of the y-axis. Accepts `number`, `string`, or `auto`. | string | | max | The end value, or maximum boundary, of the y-axis. Accepts `number`, `string`, or `auto`. | string | | boundaryGap | Axis spacing at the data extremes. The categories are inset from the edges of the axis when true. Default is true.For the `category` axis type, true places gaps at both edges.For the `time` and `value` axis types, true places a gap at the end only. | boolean | | gridLines | Horizontal grid line stroke configuration.**visible**: Shows horizontal grid lines when true. Default is false. Value is boolean. | object | | axisLine | Axis line stroke configuration.**visible**: Shows the axis line stroke when true. Ticks and labels remain visible independently. Default is true. Value is boolean. | object | | ticks | Configures tick marks along the y-axis.**visible**: Shows tick marks along the axis when true. Default is true. Value is boolean.**displayInside**: Renders tick marks on the inside of the axis line when true. Default is false. Value is boolean.**majorSplit**: The number of value-axis tick intervals. `auto` sets to the recommended value. The final count may adjust for readability, and has no effect on `category` axis types. Value is string.**minorSplit**: Number of minor tick intervals between two adjacent major ticks. Omit or set to `0` to hide. Value is number. | object | | labels | Configures tick label text.**visible**: Shows tick label text when true. Default is true. Value is boolean.**color**: Color of the tick label text. Takes precedence over the `elementStyle.color` property. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the tick label text. Takes precedence over the `elementStyle.fontSize` property. Value is number.**rotation**: Tick label rotation in degrees. Value is number.**width**: Max width in pixels before overflow handling activates. Value is number.**overflow**: Handles labels wider than the specified `width` value. Options include `none`, `truncate`, `break`, and `breakAll`. Value is string.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | | advanced | Advanced optional settings for the y-axis. See the [yAxis.advanced Properties](#yaxisadvanced-properties) section for object properties. | object | #### yAxis.advanced Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | axisPointer | Configures axis pointer settings for the y-axis alone. Only the x-axis shows a pointer, unless the chart-level shape is cross, which adds one on the y-axis as well. Turning the pointer off at the chart level will turn it off here as well. **enabled**: Displays a pointer on the axis. `auto` follows the chart-level axis pointer. Leaving this value blank removes the pointer from the axis, while other axes keep their pointers. Tooltips will still display. Value is string.**type**: Pointer shape for the axis, giving each axis its own shape under a cross pointer. Options include `auto`, `shadow`, `line`, and `none`. `shadow` requires the `category` axis type, and will shrink to a single pixel for `value` or `time` axis types. Value is string.**label**: The pointer's label text.**visible**: Shows the pointer label. Use this property to hide a cross pointer's y-axis label, which reports where the cursor is rather than a point's value. Default is `auto`. Value is string.**color**: Color of the label. Leave empty to follow the chart-level color. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the label. Empty follows the chart-level size. Value is number.**backgroundColor**: Background color of the label box. Empty follows the chart-level color. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | ### title Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | visible | Shows the chart title when true. Default is true. | boolean | | text | Main title text. | string | | color | Color of the main title text. Takes precedence over `elementStyle.color` when both are set. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx). | color | | fontSize | Font size of the main title text. Takes precedence over `elementStyle.fontSize` when both are set. | number | | subtitle | Configures the subtitle displayed beneath the main title.**text**: Subtitle text. Value is string.**color**: Color of the subtitle text. Takes precedence over `elementStyle.color` when both are set. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the subtitle text. Takes precedence over `elementStyle.fontSize` when both are set. Value is number.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | | position | Position of the title within the chart. | string | | gap | Pixel gap between the main title and subtitle. | number | | elementStyle | Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | ### visualMap Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | enabled | Enables conditional styling for all series on the chart when true. Default is true for the Basic variant. Default is false for the Conditional variant. | boolean | | dimension | Specifies which data dimension each point's min/max values are compared against, and in what units those bounds are expressed in. See the `pieces.min` property for more on how each axis type will read bounds.`y` (default) tests the plotted value of each point.`x` tests the position of the point against the x-axis.Entering a field name or column index as the value tests that dimension directly. | string | | pieces | Ordered list of threshold rules applied globally across all series. The last entry in this array will treat its max as inclusive. Points that do not match a piece are styled by the `outOfRange` property instead. | array | | outOfRange | Configures the appearance of data that no threshold range applies to. When data is out of range, the value falls outside of each configured range, or the range is toggled off in the `visualMap.legend` property. | object | | legend | Configures the legend that displays each piece and range when `visualMap` is enabled. This legend is distinct from the chart main legend.**visible**: Shows the legend when true. Default is true. Value is boolean.**position**: Legend placement within the chart. Value is string.**orientation**: Layout direction of legend items. Can be `horizontal` or `vertical`. Value is string.**interactive**: Clicking a legend item toggles the range of the item when true. Any number of items can be toggled independently. If false, the legend is inert. Ranges that are toggled off are redrawn in the `outOfRange` color instead of being removed from the chart. Value is boolean.**color**: The color of the legend item text. This value takes precedence over `elementStyle.color` when both are set. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Font size of the legend item text. This value takes precedence over `elementStyle.fontSize` when both are set.**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | ### axisPointer Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | enabled | Shows the pointer for users when true. For tooltips, the pointer follows the hovered point even when the tooltip is hidden or `tooltip.item` is set to `trigger`. If false, the pointer and label are removed. | boolean | | type | The pointer shape.`line` is a single line.`shadow` is a band as wide as one category on an x-axis.`cross` is a crosshair pattern. This is the only shape that reaches the y-axis, and the only one that can label it.`none` is no shape, leaving only the label. | string | | label | The label the pointer prints against the axis, showing the hovered x or y value. To change the tooltip formatting, use `tooltip.formatter` instead.**visible**: Shows the pointer's label against the axis when true. The label will appear on the x-axis for every pointer shape. For the cross pointer shape, both x-axis and y-axis labels will appear. Default is false. Value is boolean.**color**: Label text color. Leave empty for the default light or dark theme. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**fontSize**: Label text font size. Value is number.**backgroundColor**: Fill color of the label box. Leave empty for the default light or dark theme. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx).**elementStyle**: Visual style for a shape element rendered onto a chart canvas, including fill, stroke, opacity, shadow, and decoration. | object | ### appearance Properties | Name | Description | Property Type | | ---- | ----------- | ------------- | | colorPalette | The chart color palette. Auto-assigned to the default theme. | array | | backgroundColor | Chart background fill color. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix\reference-pages\color-selector-reference\color-selector-reference.mdx). | color | | animation | Configures chart-level entry and transition animation.**enabled**: Enables animation on chart render and update when true. Value is boolean.**entry**: Animation applied when the chart first renders. Value is object.**duration**: Entry animation duration in milliseconds. Value is number.**easing**: Easing function applied to the animation. Value is string.**delay**: Animation start delay in milliseconds. Value is number.**transition**: Animation applied when the chart data changes. Value is object.**duration**: Transition animation duration in milliseconds. Value is number.**easing**: Transition function applied to the animation. Value is string.**delay**: Animation start delay in milliseconds. Value is number. | object | ## Component Scripts and Events The Line component also has Component Events associated with it. See the [Perspective - Line Scripting](perspective-line-scripting.md) page for more information. ## Examples ### Basic Line Chart This example uses the default data for the line chart variant. Slight configuration changes were made using the `xAxis.field`, `data`, and `points.shape` properties to showcase values across the days of a given week with circular points. The sample data used to display this chart is listed below in JSON format. ![An example of a Basic Line component displaying the sample data below.](imgs/examples-basic-line-chart.png) ```JSON Title="Basic Line Chart Sample Data" [ { "props": { "data": [ { "value": 150, "day": "Mon" }, { "value": 230, "day": "Tue" }, { "value": 224, "day": "Wed" }, { "value": 218, "day": "Thu" }, { "value": 135, "day": "Fri" }, { "value": 147, "day": "Sat" }, { "value": 260, "day": "Sun" } ], "series": [ { "label": "Power", "value": "value", "line": { "type": "solid", "width": 2 }, "smooth": false, "points": { "visible": true, "size": 8, "fillColor": "", "outlineColor": "transparent", "outlineWidth": 0, "shape": "empty-circle" }, "dataLabels": { "visible": false, "position": "top", "format": "{value}", "color": "", "fontSize": "", "elementStyle": {} }, "visible": true, "referenceLines": { "animation": { "enabled": true, "entry": { "duration": 1000, "easing": "cubicOut", "delay": 0 }, "transition": { "duration": 300, "easing": "cubicOut", "delay": 0 } }, "endpoints": { "visible": true, "points": [ { "size": 4, "shape": "circle" } ] }, "items": [] }, "advanced": { "yAxis": 0, "connectNulls": false, "step": "", "tooltip": { "enabled": true, "formatter": { "type": "value", "value": "", "template": "" } } } } ], "xAxis": { "type": "category", "field": "day" } }, } ] ```