Grouped column
A grouped column chart using the x2 nested dimension. x2 is a band scale whose range is one x band wide, so setting x2="fruit" positions each column inside its group with no extra code.
- +page.svelte
- ./_components/ColumnGrouped.svelte
- ./_components/AxisX.svelte
- ./_components/AxisY.svelte
- ./_data/yearGroupsLong.js
<script>
import { LayerCake, Svg } from 'layercake';
import { scaleBand } from 'd3-scale';
import ColumnGrouped from './_components/ColumnGrouped.svelte';
import AxisX from './_components/AxisX.svelte';
import AxisY from './_components/AxisY.svelte';
// A flat list of rows, one per column: { year, fruit, value }
import data from './_data/yearGroupsLong.js';
const xKey = 'year';
const x2Key = 'fruit';
const yKey = 'value';
const seriesColors = ['#ff00cc', '#00ccff', '#ffcc00'];
// `x2="fruit"` is all it takes to position columns within each group. x2 is
// a scaleBand by default. Its domain comes from the data and its range is
// one x band wide. Pass `x2Scale` to customize the padding, for example
// `x2Scale={scaleBand().paddingInner(0.1)}`. You could also skip `x2` and
// build that band scale inside your own component.
</script>
<div class="chart-container">
<LayerCake
padding={{ top: 10, bottom: 20, left: 20 }}
x={xKey}
x2={x2Key}
y={yKey}
c={x2Key}
xScale={scaleBand().paddingInner(0.1).round(true)}
yDomain={[0, null]}
cRange={seriesColors}
{data}
>
<Svg>
<AxisX gridlines={false} />
<AxisY snapBaselineLabel />
<ColumnGrouped />
</Svg>
</LayerCake>
</div>
<style>
/* Give the wrapper a width and height. LayerCake fills it. */
.chart-container {
width: 100%;
height: 250px;
}
</style><!--
@component
Generates an SVG grouped column chart using the `x2` nested scale for the within-group position and the `c` scale for color.
-->
<script>
import { getLayerCakeContext } from 'layercake';
const k = getLayerCakeContext();
/**
* @typedef {Object} Props
* @property {string} [fill] - The shape's fill color. By default the color is read from the `c` scale.
* @property {string} [stroke='#000'] - The shape's stroke color.
* @property {number} [strokeWidth=0] - The shape's stroke width.
* @property {boolean} [showLabels=false] - Show the numbers for each column.
*/
/** @type {Props} */
let { fill, stroke = '#000', strokeWidth = 0, showLabels = false } = $props();
// Use the `fill` prop if there is one, then the `c` scale's color, then the default
/** @param {any} d */
function getFill(d) {
return fill ?? k.cGet?.(d) ?? '#00e047';
}
// This chart needs the x2 scale. A chart might not set one, so fall back
// to a zero-width column instead of crashing.
let columnWidth = $derived.by(() => {
const scale = k.x2Scale;
if (scale?.bandwidth) return scale.bandwidth();
const range = k.x2Range ?? [0, 0];
return Math.abs(range[1] - range[0]);
});
// Each column starts at zero and runs out to its value, so a negative value
// hangs below zero. Keep zero inside your yDomain, or columns will be drawn
// outside the chart.
let zeroY = $derived(k.yScale(0));
</script>
<g class="column-group">
{#each k.data as d, i}
{@const valueY = k.yGet(d)}
{@const xPos = k.xGet(d) + (k.x2Get?.(d) ?? 0)}
{@const yValue = k.y(d)}
<rect
class="group-rect"
data-id={i}
data-range={k.x(d)}
data-count={yValue}
x={xPos}
y={Math.min(zeroY, valueY)}
width={columnWidth}
height={Math.abs(valueY - zeroY)}
fill={getFill(d)}
{stroke}
stroke-width={strokeWidth}
/>
{#if showLabels && yValue != null}
{@const pointsUp = valueY < zeroY}
<!--
Put the number just past the far end of the column: above a positive
column and below a negative one. Switching the text baseline keeps the
gap the same at any font size.
-->
<text
x={xPos + columnWidth / 2}
y={valueY}
dy={pointsUp ? -5 : 5}
text-anchor="middle"
dominant-baseline={pointsUp ? 'auto' : 'hanging'}>{yValue}</text
>
{/if}
{/each}
</g>
<style>
text {
font-size: 12px;
}
</style><!--
@component
Generates an SVG x-axis along the bottom of the chart. If the x scale is a band scale, each tick sits in the middle of its band.
-->
<script>
import { getLayerCakeContext } from 'layercake';
const k = getLayerCakeContext();
/**
* @typedef {Object} Props
* @property {boolean} [tickMarks=false] - Show a vertical mark at each tick.
* @property {boolean} [gridlines=true] - Show gridlines extending into the chart area.
* @property {number} [tickMarkLength=6] - The length of the tick mark.
* @property {boolean} [showBaseline=false] - Show a solid line along the bottom of the chart.
* @property {boolean} [snapLabels=false] - Instead of centering the text labels on the first and the last items, align them to the edges of the chart.
* @property {(d: any) => string} [format=d => d] - Formats a tick value for display.
* @property {number|Array<any>|((ticks: Array<any>) => Array<any>)} [ticks] - If this is a number, it passes that along to the [d3Scale.ticks](https://github.com/d3/d3-scale) function. If this is an array, hardcodes the ticks to those values. If it's a function, passes along the default tick values and expects an array of tick values in return. If nothing, it uses the default ticks supplied by the D3 function.
* @property {number} [tickGutter=0] - The gap in pixels between the bottom of the chart area and the start of the tick.
* @property {number} [dx=0] - Horizontal offset of the label in pixels.
* @property {number} [dy=12] - Vertical offset of the label in pixels.
*/
/** @type {Props} */
let {
tickMarks = false,
gridlines = true,
tickMarkLength = 6,
showBaseline = false,
snapLabels = false,
format = d => d,
ticks = undefined,
tickGutter = 0,
dx = 0,
dy = 12
} = $props();
// Snapped labels anchor the first tick to the left edge and the last to the right
/** @param {number} i */
function textAnchor(i) {
if (snapLabels === true) {
if (i === 0) {
return 'start';
}
if (i === tickVals.length - 1) {
return 'end';
}
}
return 'middle';
}
let tickLen = $derived(tickMarks === true ? (tickMarkLength ?? 6) : 0);
let isBandwidth = $derived(typeof k.xScale.bandwidth === 'function');
/** @type {Array<any>} */
let tickVals = $derived(
Array.isArray(ticks)
? ticks
: isBandwidth
? k.xScale.domain()
: typeof ticks === 'function'
? ticks(k.xScale.ticks())
: k.xScale.ticks(ticks)
);
let halfBand = $derived(isBandwidth ? k.xScale.bandwidth() / 2 : 0);
</script>
<g class="axis x-axis" class:snapLabels>
{#if showBaseline === true}
<line class="baseline" y1={k.height} y2={k.height} x1="0" x2={k.width} />
{/if}
{#each tickVals as tick, i (tick)}
<!-- Fall back to the chart height if the chart has no y dimension -->
<g
class="tick tick-{i}"
transform="translate({k.xScale(tick)},{k.yRange ? Math.max(...k.yRange) : k.height})"
>
{#if gridlines === true}
<line class="gridline" x1={halfBand} x2={halfBand} y1={-k.height} y2="0" />
{/if}
{#if tickMarks === true}
<line
class="tick-mark"
x1={halfBand}
x2={halfBand}
y1={tickGutter}
y2={tickGutter + tickLen}
/>
{/if}
<text x={halfBand} y={tickGutter + tickLen} {dx} {dy} text-anchor={textAnchor(i)}
>{format(tick)}</text
>
</g>
{/each}
</g>
<style>
.tick {
font-size: 11px;
}
line,
.tick line {
stroke: #aaa;
stroke-dasharray: 2;
}
.tick text {
fill: #666;
}
.tick .tick-mark,
.baseline {
stroke-dasharray: 0;
}
/* Push the snapped end labels 3px outward so they clear the chart edge */
.axis.snapLabels .tick:last-child text {
transform: translateX(3px);
}
.axis.snapLabels .tick.tick-0 text {
transform: translateX(-3px);
}
</style><!--
@component
Generates an SVG y-axis along the left edge of the chart. If the y scale is a band scale, each tick sits in the middle of its band.
-->
<script>
import { getLayerCakeContext } from 'layercake';
const k = getLayerCakeContext();
/**
* @typedef {Object} Props
* @property {boolean} [tickMarks=false] - Show a horizontal mark at each tick.
* @property {'even'|'above'} [labelPosition='even'] - Whether the label sits level with its tick ('even') or above it ('above').
* @property {boolean} [snapBaselineLabel=false] - When labelPosition='even', adjust the lowest label so that it sits above the tick mark.
* @property {boolean} [gridlines=true] - Show gridlines extending into the chart area.
* @property {number} [tickMarkLength] - Length of the tick mark in pixels. Defaults to the width of the widest label when `labelPosition` is 'above', otherwise 6.
* @property {(d: any) => string} [format=d => d] - Formats a tick value for display.
* @property {number|Array<any>|((ticks: Array<any>) => Array<any>)} [ticks=4] - If this is a number, it passes that along to the [d3Scale.ticks](https://github.com/d3/d3-scale) function. If this is an array, hardcodes the ticks to those values. If it's a function, passes along the default tick values and expects an array of tick values in return.
* @property {number} [tickGutter=0] - The gap in pixels between the left edge of the chart area and the tick.
* @property {number} [dx=0] - Horizontal offset of the label in pixels.
* @property {number} [dy=0] - Vertical offset of the label in pixels.
* @property {number} [charPixelWidth=7.25] - Used to calculate the widest label length to offset labels. Adjust if the automatic tick length doesn't look right because you have a bigger font (or just set `tickMarkLength` to a pixel value).
*/
/** @type {Props} */
let {
tickMarks = false,
labelPosition = 'even',
snapBaselineLabel = false,
gridlines = true,
tickMarkLength = undefined,
format = d => d,
ticks = 4,
tickGutter = 0,
dx = 0,
dy = 0,
charPixelWidth = 7.25
} = $props();
/** @param {number} sum
* @param {string} val */
function calcStringLength(sum, val) {
if (val === ',' || val === '.') return sum + charPixelWidth * 0.5;
return sum + charPixelWidth;
}
let isBandwidth = $derived(typeof k.yScale.bandwidth === 'function');
/** @type {Array<any>} */
let tickVals = $derived(
Array.isArray(ticks)
? ticks
: isBandwidth
? k.yScale.domain()
: typeof ticks === 'function'
? ticks(k.yScale.ticks())
: k.yScale.ticks(ticks)
);
let widestTickLen = $derived(
Math.max(
10,
Math.max(...tickVals.map(d => format(d).toString().split('').reduce(calcStringLength, 0)))
)
);
let tickLen = $derived(
tickMarks === true
? labelPosition === 'above'
? (tickMarkLength ?? widestTickLen)
: (tickMarkLength ?? 6)
: 0
);
let x1 = $derived(-tickGutter - (labelPosition === 'above' ? widestTickLen : tickLen));
let halfBand = $derived(isBandwidth ? k.yScale.bandwidth() / 2 : 0);
let maxTickValPx = $derived(Math.max(...tickVals.map(k.yScale)));
</script>
<g class="axis y-axis">
{#each tickVals as tick (tick)}
{@const tickValPx = k.yScale(tick)}
<!-- Fall back to the left edge if the chart has no x dimension -->
<g class="tick tick-{tick}" transform="translate({k.xRange ? k.xRange[0] : 0}, {tickValPx})">
{#if gridlines === true}
<line class="gridline" {x1} x2={k.width} y1={halfBand} y2={halfBand}></line>
{/if}
{#if tickMarks === true}
<line class="tick-mark" {x1} x2={x1 + tickLen} y1={halfBand} y2={halfBand}></line>
{/if}
<text
x={x1}
y={halfBand}
dx={dx + (labelPosition === 'even' ? -3 : 0)}
text-anchor={labelPosition === 'above' ? 'start' : 'end'}
dy={dy +
(labelPosition === 'above' || (snapBaselineLabel === true && tickValPx === maxTickValPx)
? -3
: 4)}>{format(tick)}</text
>
</g>
{/each}
</g>
<style>
.tick {
font-size: 11px;
}
.tick line {
stroke: #aaa;
}
.tick .gridline {
stroke-dasharray: 2;
}
.tick text {
fill: #666;
}
/* A solid line at the zero tick */
.tick.tick-0 line {
stroke-dasharray: 0;
}
</style>export default [
{ year: '1979', fruit: 'apples', value: 2 },
{ year: '1979', fruit: 'bananas', value: 15 },
{ year: '1979', fruit: 'cherries', value: 8 },
{ year: '1980', fruit: 'apples', value: 3 },
{ year: '1980', fruit: 'bananas', value: 10 },
{ year: '1980', fruit: 'cherries', value: 9 },
{ year: '1981', fruit: 'apples', value: 5 },
{ year: '1981', fruit: 'bananas', value: 8 },
{ year: '1981', fruit: 'cherries', value: 11 },
{ year: '1982', fruit: 'apples', value: 8 },
{ year: '1982', fruit: 'bananas', value: 5 },
{ year: '1982', fruit: 'cherries', value: 12 },
{ year: '1983', fruit: 'apples', value: 18 },
{ year: '1983', fruit: 'bananas', value: 3 },
{ year: '1983', fruit: 'cherries', value: 14 }
];