Marimekko Chart
marimekko-chartuiMarimekko (mosaic) chart around Apache ECharts custom series. Column widths encode column totals, stacked segments encode within-column shares, with in-canvas labels. Theme-aware via registry tokens.
Installation
$pnpm dlx shadcn-svelte@latest add https://uipkge.dev/r/svelte/marimekko-chart.json$npx shadcn-svelte@latest add https://uipkge.dev/r/svelte/marimekko-chart.json$yarn dlx shadcn-svelte@latest add https://uipkge.dev/r/svelte/marimekko-chart.json$bunx shadcn-svelte@latest add https://uipkge.dev/r/svelte/marimekko-chart.jsonManifest:
https://uipkge.dev/r/svelte/marimekko-chart.jsonInstalls to:src/lib/components/ui/marimekko-chart/Examples
Loading interactive previews…
Loading interactive previews…
Props
| Name | Type / Values | Default | Required |
|---|---|---|---|
columns | MekkoColumn[] | — | required |
height | number | string | 340 | optional |
option | any | — | optional |
ariaLabelAccessible name announced for the chart image. Defaults to "Chart". | string | — | optional |
ref | HTMLDivElement | null | — | optional |
npm dependencies
Used by
Files installed (3)
src/lib/components/ui/marimekko-chart/MarimekkoChart.svelte7.6 kB
<script lang="ts" module> import type { HTMLAttributes } from 'svelte/elements' export interface MekkoColumn { name: string values: { name: string; value: number }[] } export interface MarimekkoChartProps extends HTMLAttributes<HTMLDivElement> { columns: MekkoColumn[] height?: number | string option?: any /** Accessible name announced for the chart image. Defaults to "Chart". */ ariaLabel?: string ref?: HTMLDivElement | null } // NOTE: `echarts` is a consumer dependency (see the sidecar // `dependencies`), not installed in this repo — the ts-ignore comments // below keep `svelte-check` green in the monorepo while consumers get // fully typed ECharts. // @ts-ignore: consumer dependency, resolved in the consumer project import * as echarts from 'echarts/core' // @ts-ignore: consumer dependency, resolved in the consumer project import { CanvasRenderer } from 'echarts/renderers' // @ts-ignore: consumer dependency, resolved in the consumer project import { CustomChart as EChartsCustomChart } from 'echarts/charts' // @ts-ignore: consumer dependency, resolved in the consumer project import { GridComponent, TooltipComponent, LegendComponent } from 'echarts/components' echarts.use([CanvasRenderer, EChartsCustomChart, GridComponent, TooltipComponent, LegendComponent]) </script> <script lang="ts"> import { cn } from '$lib/utils' import { getChartColors, getChartTextColor, getChartTooltipBg, getChartTooltipBorder, getChartTooltipText, mergeOptionBlock, watchThemeChange, } from './useChartTheme' let { class: className, columns, height = 340, option, ariaLabel, ref = $bindable(null), ...restProps }: MarimekkoChartProps = $props() let container: HTMLDivElement | null = $state(null) // Bumped by the theme watcher so the derived option re-resolves tokens. let themeTick = $state(0) const segments = $derived(Array.from(new Set(columns.flatMap((c) => c.values.map((v) => v.name))))) interface MekkoRect { x0: number x1: number y0: number y1: number name: string value: number column: string firstInColumn: boolean } // 100×100 value space: column widths ∝ column totals (x), segment // heights ∝ within-column shares (y, stacked bottom-up). Column labels // render as in-canvas text below y=0 (axis floor is -10 for room). const flat = $derived.by((): MekkoRect[] => { const grand = columns.reduce((s, c) => s + c.values.reduce((a, v) => a + v.value, 0), 0) || 1 let x = 0 return columns.flatMap((c) => { const total = c.values.reduce((s, v) => s + v.value, 0) const w = (total / grand) * 100 let y = 0 const rects = c.values.map((v, vi) => { const h = total ? (v.value / total) * 100 : 0 const rect: MekkoRect = { x0: x, x1: x + w, y0: y, y1: y + h, name: v.name, value: v.value, column: c.name, firstInColumn: vi === 0, } y += h return rect }) x += w return rects }) }) const mergedOption = $derived.by(() => { themeTick const rects = flat const segNames = segments const palette = getChartColors() const textColor = getChartTextColor() const series = [ { type: 'custom', renderItem: (params: any, api: any) => { const s: MekkoRect = rects[params.dataIndex] const [px0, py1] = api.coord([s.x0, s.y1]) const [px1, py0] = api.coord([s.x1, s.y0]) const color = palette[segNames.indexOf(s.name) % palette.length] const w = Math.abs(px1 - px0) const h = Math.abs(py1 - py0) const children: any[] = [ { type: 'rect', shape: { x: Math.min(px0, px1), y: Math.min(py0, py1), width: Math.max(1, w), height: Math.max(1, h), r: 2, }, style: { fill: color }, }, ] if (w > 48 && h > 20) { children.push({ type: 'text', style: { x: (px0 + px1) / 2, y: (py0 + py1) / 2, text: `${s.name} ${Math.round(s.y1 - s.y0)}%`, fill: '#fff', fontSize: 10, fontWeight: 600, align: 'center', verticalAlign: 'middle', }, }) } if (s.firstInColumn && w > 30) { const [lx] = api.coord([(s.x0 + s.x1) / 2, 0]) const [, ly] = api.coord([0, -5]) children.push({ type: 'text', style: { x: lx, y: ly, text: `${s.column} (${Math.round(s.x1 - s.x0)}%)`, fill: textColor, fontSize: 10, fontWeight: 600, align: 'center', verticalAlign: 'middle', }, }) } return { type: 'group', children } }, data: rects.map((s) => [s.x0, s.y0, s.x1, s.y1]), }, ] const userOption: any = option ?? {} const { series: userSeries, xAxis: userXAxis, yAxis: userYAxis, grid: userGrid, tooltip: userTooltip, legend: userLegend, ...userRest } = userOption const mergedSeries = Array.isArray(userSeries) ? series.map((s, i) => ({ ...s, ...(userSeries[i] ?? {}) })) : series return { color: palette, grid: mergeOptionBlock({ left: 8, right: 8, top: 16, bottom: 36, containLabel: false }, userGrid), tooltip: mergeOptionBlock( { trigger: 'item', backgroundColor: getChartTooltipBg(), borderColor: getChartTooltipBorder(), textStyle: { color: getChartTooltipText(), fontSize: 12 }, formatter: (p: any) => { const s: MekkoRect | undefined = rects[p.dataIndex] return s ? `${s.column} · ${s.name}<br/>${s.value} (${Math.round(s.x1 - s.x0)}% of width)` : '' }, }, userTooltip, ), legend: mergeOptionBlock( { bottom: 0, icon: 'circle', itemWidth: 8, itemHeight: 8, textStyle: { fontSize: 11, color: textColor }, data: segNames, }, userLegend, ), xAxis: mergeOptionBlock({ type: 'value', min: 0, max: 100, show: false }, userXAxis), yAxis: mergeOptionBlock({ type: 'value', min: -12, max: 100, show: false }, userYAxis), series: mergedSeries, ...userRest, } }) let chart: any = null $effect(() => { if (!container) return chart = echarts.init(container) // Autoresize (the vue-echarts `:autoresize` equivalent). const ro = new ResizeObserver(() => chart?.resize()) ro.observe(container) const unwatchTheme = watchThemeChange(() => { themeTick++ }) return () => { unwatchTheme() ro.disconnect() chart?.dispose() chart = null } }) $effect(() => { const opt = mergedOption chart?.setOption(opt, true) }) const heightStyle = $derived(/^\d+$/.test(String(height)) ? `${height}px` : String(height)) </script> <!-- svelte-ignore a11y_no_noninteractive_tabindex: chart is intentionally focusable (mirrors the Vue twin) --> <div bind:this={ref} role="img" tabindex="0" aria-label={ariaLabel || 'Marimekko chart'} style:height={heightStyle} class={cn('focus-visible:ring-ring w-full focus-visible:ring-2 focus-visible:outline-none', className)} {...restProps} > <div bind:this={container} class="size-full"></div> </div>src/lib/components/ui/marimekko-chart/index.ts0.1 kB
export { default as MarimekkoChart, type MarimekkoChartProps, type MekkoColumn } from './MarimekkoChart.svelte'src/lib/components/ui/marimekko-chart/useChartTheme.ts8 kB
// Chart palette is driven by Tailwind v4 CSS variables (`--chart-1`..`--chart-5`, // `--muted-foreground`, `--border`, `--popover`, etc.) so dark/light flips // happen automatically when the consumer toggles their theme class. The // values resolve at runtime via `getComputedStyle`, so they pick up whatever // the consumer set in their own `tailwind.css` -- no fork required. // // This is the Svelte twin of the Vue `useChartTheme.ts`: plain getter // functions (no Vue `computed`) plus `watchThemeChange` for reactivity. // Consuming components bump a local `$state` tick inside the watcher so // their `$derived` ECharts options re-resolve and re-paint. // ECharts' canvas renderer does not accept OKLCH in every browser. Assigning // one of our Tailwind tokens to `fillStyle` can silently leave the sentinel // colour in place, turning a whole chart black. Convert OKLCH ourselves and // let the canvas normalize older CSS colour formats. let _hexCanvas: CanvasRenderingContext2D | null = null export function toCanvasColor(cssColor: string): string { const value = cssColor.trim() const match = value.match( /^oklch\(\s*([+-]?(?:\d+\.?\d*|\.\d+))(%?)\s+([+-]?(?:\d+\.?\d*|\.\d+))\s+([+-]?(?:\d+\.?\d*|\.\d+))(?:deg)?(?:\s*\/\s*([+-]?(?:\d+\.?\d*|\.\d+))(%?))?\s*\)$/i, ) if (match) { const lightness = Number(match[1]) / (match[2] === '%' ? 100 : 1) const chroma = Number(match[3]) const hue = (Number(match[4]) * Math.PI) / 180 const alpha = match[5] == null ? 1 : Number(match[5]) / (match[6] === '%' ? 100 : 1) const a = chroma * Math.cos(hue) const b = chroma * Math.sin(hue) const l = Math.pow(lightness + 0.3963377774 * a + 0.2158037573 * b, 3) const m = Math.pow(lightness - 0.1055613458 * a - 0.0638541728 * b, 3) const s = Math.pow(lightness - 0.0894841775 * a - 1.291485548 * b, 3) const linear = [ 4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s, -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s, -0.0041960863 * l - 0.7034186147 * m + 1.707614701 * s, ] const rgb = linear.map((channel) => { const encoded = channel <= 0.0031308 ? 12.92 * channel : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055 return Math.round(Math.min(1, Math.max(0, encoded)) * 255) }) return alpha < 1 ? `rgba(${rgb.join(', ')}, ${alpha})` : `rgb(${rgb.join(', ')})` } if (typeof document === 'undefined') return cssColor if (!_hexCanvas) { _hexCanvas = document.createElement('canvas').getContext('2d') } if (!_hexCanvas) return cssColor _hexCanvas.fillStyle = '#010203' _hexCanvas.fillStyle = value const normalized = _hexCanvas.fillStyle as string return normalized === '#010203' && value.toLowerCase() !== '#010203' ? value : normalized } // Convert any CSS color (hex, rgb, oklch, color()) + alpha 0..1 to a // canvas-safe rgba(r,g,b,a). `colorString + '40'` (8-digit hex alpha) // only works when `colorString` is `#rrggbb`; once tokens resolve to // oklch() post-hydration the gradient stops break and the canvas paint // throws every frame. Stay defensive and always return rgba. export function toRgba(cssColor: string, alpha: number): string { const normalized = toCanvasColor(cssColor) if (normalized.startsWith('#') && normalized.length === 7) { const r = parseInt(normalized.slice(1, 3), 16) const g = parseInt(normalized.slice(3, 5), 16) const b = parseInt(normalized.slice(5, 7), 16) return `rgba(${r},${g},${b},${alpha})` } if (normalized.startsWith('rgba(')) { return normalized.replace(/,\s*[\d.]+\s*\)$/, `,${alpha})`) } if (normalized.startsWith('rgb(')) { return normalized.replace(/^rgb\(/, 'rgba(').replace(/\)$/, `,${alpha})`) } // Canvas refused to parse this color -- ship the original string and // let ECharts complain (better than crashing the paint loop). return cssColor } function resolveVar(name: string, fallback: string): string { if (typeof window === 'undefined') return fallback const v = getComputedStyle(document.documentElement).getPropertyValue(name).trim() if (!v) return fallback return toCanvasColor(v) } // SSR / pre-hydration fallback palette. Hex values picked to roughly // match the shadcn Neutral defaults in `tailwind.css` so the first paint // doesn't flicker. const CHART_FALLBACK = ['#f59e0b', '#14b8a6', '#3b82f6', '#f97316', '#eab308'] export function getChartColors(): string[] { return Array.from({ length: 5 }, (_, i) => resolveVar(`--chart-${i + 1}`, CHART_FALLBACK[i]!)) } export function getChartTextColor(): string { return resolveVar('--muted-foreground', '#888888') } export function getChartAxisColor(): string { return resolveVar('--border', '#e5e5e5') } export function getChartSplitLineColor(): string { return resolveVar('--border', '#f0f0f0') } export function getChartTooltipBg(): string { return resolveVar('--popover', 'rgba(255,255,255,0.96)') } export function getChartTooltipBorder(): string { return resolveVar('--border', '#e5e5e5') } export function getChartTooltipText(): string { return resolveVar('--popover-foreground', '#333333') } export function getChartBgColor(): string { return resolveVar('--card', resolveVar('--background', '#ffffff')) } // The app's accent, for the one highlighted element on a chart or map — a // selected route, a focused bar. Category series keep using chartColors. export function getChartAccentColor(): string { return resolveVar('--primary', '#38bdf8') } // Out-of-bounds / failure colour for charts that encode good vs bad rather // than a category — control limits, error series. CSS-level marks can use // `var(--destructive)` directly; this exists because ECharts needs a resolved // colour string on the canvas. export function getChartDangerColor(): string { return resolveVar('--destructive', '#dc2626') } // Observe the `<html>` class/style pivots shadcn dark mode flips, plus one // first-paint bump so post-hydration getComputedStyle reads the *resolved* // CSS values. Returns an unsubscribe function for `$effect` cleanup. export function watchThemeChange(onChange: () => void): () => void { if (typeof window === 'undefined') return () => {} let raf = requestAnimationFrame(onChange) const observer = new MutationObserver(onChange) observer.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'style', 'data-theme'], }) return () => { cancelAnimationFrame(raf) observer.disconnect() } } // Two-level deep merge for ECharts option blocks (xAxis, yAxis, grid, // tooltip, legend, singleAxis, parallel, etc.). The top-level keys merge // shallowly, but one nested level (axisLabel, axisLine, splitLine, etc.) // merges shallowly too so a consumer passing `xAxis: { axisLabel: { fontSize: 9 } }` // doesn't blow away the wrapper's `color` + base font defaults on the same // axisLabel block. Arrays + primitives replace outright. // // This is the merge strategy the chart wrappers use to fold `props.option` // onto their computed base option without forcing consumers to spell out // every default they want to preserve. export function mergeOptionBlock<T extends Record<string, any>>(base: T, user: Partial<T> | undefined): T { if (!user) return base const out: any = { ...base } for (const k of Object.keys(user)) { const bv = (base as any)[k] const uv = (user as any)[k] if ( bv != null && uv != null && typeof bv === 'object' && typeof uv === 'object' && !Array.isArray(bv) && !Array.isArray(uv) ) { out[k] = { ...bv, ...uv } } else { out[k] = uv } } return out } // Default gauge stoplight: teal (safe) -> amber (warning) -> red (danger). // Pulled off saturated green and onto teal so the gauge ties back to the // dashboard palette; red is kept as the universal "limit reached" cue. // GaugeChart consumes this via its `thresholds` prop default; consumers // pass their own array to override. Static because gauges have semantic // meaning (green safe / red danger) that we deliberately don't theme-flip. export const gaugeThresholds: [number, string][] = [ [0.6, '#14b8a6'], [0.85, '#f59e0b'], [1, '#dc2626'], ]
Raw manifest:https://uipkge.dev/r/svelte/marimekko-chart.json