Archived

Documentation for Layer Cake v10, before Svelte 5 runes. Current docs at layercake.graphics

Menu

Diverging column

2015
2016
2017
2018
2019
2020
2021
2022
2023
-5
0
5

A column chart with negative and positive values. The yDomain function stretches the measured domain so it always includes zero, and a c scale colors each column by whether its value is up or down.

This is the server-side rendered version. ssr and percentRange on <LayerCake> put the scales in percentages, so the chart renders before the browser measures it. The axes are HTML components and the marks sit in a <ScaledSvg> that stretches to fit its box. The client-side version also adds yPadding and a label on each column. Both are set in pixels, which a percent-range chart can't use, so they are left out here.

  • +page.svelte
  • ./_components/Column.svelte
  • ./_components/AxisX.percent-range.html.svelte
  • ./_components/AxisY.percent-range.html.svelte
  • ./_data/yearChanges.csv
<script>
  import { LayerCake, ScaledSvg, Html } from 'layercake';
  import { scaleBand } from 'd3-scale';

  import Column from './_components/Column.svelte';
  import AxisX from './_components/AxisX.percent-range.html.svelte';
  import AxisY from './_components/AxisY.percent-range.html.svelte';

  // The CSV rows are parsed, and their numbers typed, by @rollup/plugin-dsv. See vite.config.js
  import data from './_data/yearChanges.csv';

  const xKey = 'year';
  const yKey = 'change';
</script>

<div class="chart-container">
  <!--
    The columns grow out of zero, so zero has to be inside the domain. The
    `yDomain` function receives the [min, max] measured from the data and
    stretches whichever end doesn't reach zero. It works whether the numbers
    are all positive, all negative or a mix.

    The `c` scale turns each row's "up" or "down" into a color for the
    Column component.

    The client-side version also adds `yPadding` and column labels. Both are
    in pixels, which a percent-range chart can't use, so they are left out here.
  -->
  <LayerCake
    ssr
    percentRange
    padding={{ top: 10, bottom: 20, left: 25 }}
    x={xKey}
    y={yKey}
    xScale={scaleBand().paddingInner(0.05)}
    yDomain={([min, max]) => [Math.min(0, min), Math.max(0, max)]}
    c={d => (d[yKey] < 0 ? 'down' : 'up')}
    cDomain={['up', 'down']}
    cRange={['#00e047', '#ff00cc']}
    {data}
  >
    {#snippet children(k)}
      <Html>
        <AxisX gridlines={false} tickMarks snapLabels />
        <AxisY />
      </Html>
      <ScaledSvg>
        <Column />
        <!-- Columns run up and down from here, so mark it -->
        <line class="zero" x1={k.xRange[0]} x2={k.xRange[1]} y1={k.yScale(0)} y2={k.yScale(0)} />
      </ScaledSvg>
    {/snippet}
  </LayerCake>
</div>

<style>
  /* Give the wrapper a width and height. LayerCake fills it. */
  .chart-container {
    width: 100%;
    height: 250px;
  }

  .zero {
    stroke: #333;
    /* The ScaledSvg stretches to fill its box, so undo that for the stroke */
    vector-effect: non-scaling-stroke;
  }
</style>