Chart Line Hds

<sl-chart-line-hds> | SlChartLineHds
Since 2.0 experimental

Line chart to display overlapping data over time.

Examples

Line Chart with Dark Popover 

<sl-chart-line-hds id="hds-line-chart-dark"></sl-chart-line-hds>
<script>

  const lineChart = document.getElementById('hds-line-chart-dark');

  lineChart.chartTitle = "Portfolio Performance (Dark)"
  lineChart.popoverTheme = "dark"
  lineChart.yLabel = 'Y-axis title name goes here';
  lineChart.xLabel = 'X-axis title name goes here';
  lineChart.data = [
    {
      label: "The first Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 10 },
        { date: new Date('2023-02-01'), value: 20 },
        { date: new Date('2023-03-01'), value: 22 },
        { date: new Date('2023-04-01'), value: 27 },
        { date: new Date('2023-05-01'), value: 37 },
      ],
    }, {
      label: "The second Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 15 },
        { date: new Date('2023-02-01'), value: 25 },
        { date: new Date('2023-03-01'), value: 12 },
        { date: new Date('2023-04-01'), value: 11 },
        { date: new Date('2023-05-01'), value: -2 },
      ],
    }, {
      label: "The Third Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 20 },
        { date: new Date('2023-02-01'), value: 15 },
        { date: new Date('2023-03-01'), value: 30 },
        { date: new Date('2023-04-01'), value: 10 },
        { date: new Date('2023-05-01'), value: 14 },
      ],
    }, {
      label: "The Forth Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 5 },
        { date: new Date('2023-02-01'), value: -20 },
        { date: new Date('2023-03-01'), value: -4 },
        { date: new Date('2023-04-01'), value: 0 },
        { date: new Date('2023-05-01'), value: 14 },
      ],
    }
  ];

</script>

Second Example 

<sl-chart-line-hds id="hds-line-chart"></sl-chart-line-hds>
<script>

  const lineChart = document.getElementById('hds-line-chart');

  lineChart.chartTitle = "Portfolio Performance (Light)"
  lineChart.popoverTheme = "light"
  lineChart.data = [
    {
      label: "The first Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 10 },
        { date: new Date('2023-02-01'), value: 20 },
        { date: new Date('2023-03-01'), value: 22 },
        { date: new Date('2023-04-01'), value: 27 },
        { date: new Date('2023-05-01'), value: 37 },
      ],
    }, {
      label: "The second Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 15 },
        { date: new Date('2023-02-01'), value: 25 },
        { date: new Date('2023-03-01'), value: 12 },
        { date: new Date('2023-04-01'), value: 11 },
        { date: new Date('2023-05-01'), value: -2 },
      ],
    }, {
      label: "The Third Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 20 },
        { date: new Date('2023-02-01'), value: 15 },
        { date: new Date('2023-03-01'), value: 30 },
        { date: new Date('2023-04-01'), value: 10 },
        { date: new Date('2023-05-01'), value: 14 },
      ],
    }, {
      label: "The Forth Data Line",
      lineData: [
        { date: new Date('2023-01-01'), value: 5 },
        { date: new Date('2023-02-01'), value: 12 },
        { date: new Date('2023-03-01'), value: -4 },
        { date: new Date('2023-04-01'), value: 20 },
        { date: new Date('2023-05-01'), value: 14 },
      ],
    }
  ];

</script>

Next Steps

Task: Scale Jump

Definition: One or more metrics have a disproportionate value to the rest positive or negative

Potential Solution:

  1. Define the median range for all values
  2. Define the outliers
  3. Define the value that needs to be ‘skipped’
  4. Break the Y scale into 2 objects where the first object ends at the edge of the median range and the second object is defined by the remaining value minus the ‘skipped’ value.
  5. Break the outlier lines into 2 objects where the first object ends at the edge of the median range and the second object is defined by the remaining value minus the ‘skipped’ value.

This approach assumes the ‘skipped-value’ would be passed to the component manually

[component-metadata:sl-chart-line-hds]

Slots

Name Description
(default) The default slot.
example An example slot.

Learn more about using slots.

Properties

Name Description Reflects Type Default
data The data to be displayed in the chart. LineData[] []
chartTitle
chart-title 		The title of the chart. string ''
height The height of the chart. number 500
theme The theme of the chart. string 'default'
themeColors
theme-colors 		The theme colors of the chart. array []
isResponsive
responsive 		The responsiveness of the chart. boolean false
xLabel
x-label 		Label for the X Axis of the chart. string ''
yLabel
y-label 		Label for the Y Axis of the chart. string ''
showXAxis
show-x-axis 		Show the X Axis of the chart. boolean true
showYAxis
show-y-axis 		Show the Y Axis of the chart. boolean true
showLegend
show-legend 		Show legend boolean true
showGridLines
show-grid-lines 		Show grid lines boolean true
strokeWidth
stroke-width 		Set stroke with of graph line values number 2
updateComplete A read-only promise that resolves when the component has finished updating.

Learn more about attributes and properties.

Events

Name React Event Description Event Detail
sl-event-name Emitted as an example. -

Learn more about events.

Custom Properties

Name Description Default
--example An example CSS custom property.

Learn more about customizing CSS custom properties.

Parts

Name Description
base The component’s base wrapper.

Learn more about customizing CSS parts.

Dependencies

This component automatically imports the following dependencies.

  • <sl-example>