Tree Chart
tree-chartuiHierarchical tree wrapper around Apache ECharts. Orthogonal (LR/TB/RL/BT) or radial layout, optional roam, focus-on-hover for descendants.
Installation
$pnpm dlx shadcn-svelte@latest add https://uipkge.dev/r/svelte/tree-chart.json$npx shadcn-svelte@latest add https://uipkge.dev/r/svelte/tree-chart.json$yarn dlx shadcn-svelte@latest add https://uipkge.dev/r/svelte/tree-chart.json$bunx shadcn-svelte@latest add https://uipkge.dev/r/svelte/tree-chart.jsonManifest:
https://uipkge.dev/r/svelte/tree-chart.jsonInstalls to:src/lib/components/ui/tree-chart/Examples
Loading interactive previews…
Loading interactive previews…
Props
| Name | Type / Values | Default | Required |
|---|---|---|---|
data | TreeChartNode | — | required |
orient`LR` (left-to-right, default), `TB` (top-down), `RL`, `BT`, or `radial`. | 'LR' | 'TB' | 'RL' | 'BT' | 'radial' | LR | optional |
roamAllow click-and-drag pan. Default false. | boolean | false | optional |
height | number | string | 380 | 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/tree-chart/TreeChart.svelte4.5 kB
<script lang="ts" module> import type { HTMLAttributes } from 'svelte/elements' export interface TreeChartNode { name: string value?: number children?: TreeChartNode[] /** Collapse this branch on initial render. */ collapsed?: boolean } export interface TreeChartProps extends HTMLAttributes<HTMLDivElement> { data: TreeChartNode /** `LR` (left-to-right, default), `TB` (top-down), `RL`, `BT`, or `radial`. */ orient?: 'LR' | 'TB' | 'RL' | 'BT' | 'radial' /** Allow click-and-drag pan. Default false. */ roam?: boolean height?: number | string option?: any /** Accessible name announced for the chart image. Defaults to "Chart". */ ariaLabel?: string ref?: HTMLDivElement | null } </script> <script lang="ts"> import { onMount } from 'svelte' import { init, use, type ECharts } from 'echarts/core' import { CanvasRenderer } from 'echarts/renderers' import { TreeChart as EChartsTreeChart } from 'echarts/charts' import { TooltipComponent } from 'echarts/components' import { cn } from '$lib/utils' import { getChartAxisColor, getChartColors, getChartTextColor, getChartTooltipBg, getChartTooltipBorder, getChartTooltipText, } from './chart-theme' use([CanvasRenderer, EChartsTreeChart, TooltipComponent]) let { data, orient = 'LR', roam = false, height = 380, option, class: className, ariaLabel, ref = $bindable(null), ...restProps }: TreeChartProps = $props() // Theme version: bumped on mount and whenever `<html>` class/style changes // (the typical dark-mode pivot) so the derived option re-resolves // CSS-driven colors and the chart re-paints. let themeKey = $state(0) onMount(() => { themeKey++ const mo = new MutationObserver(() => themeKey++) mo.observe(document.documentElement, { attributes: true, attributeFilter: ['class', 'style', 'data-theme'], }) return () => mo.disconnect() }) const mergedOption = $derived.by(() => { void themeKey const layout = orient === 'radial' ? ('radial' as const) : ('orthogonal' as const) const textColor = getChartTextColor() const axisColor = getChartAxisColor() const colors = getChartColors() const series = [ { type: 'tree', data: [data], layout, orient: layout === 'orthogonal' ? orient : undefined, roam, symbol: 'circle', symbolSize: 10, initialTreeDepth: -1, top: 16, bottom: 16, left: layout === 'radial' ? '5%' : 16, right: layout === 'radial' ? '5%' : 60, label: { fontSize: 11, color: textColor, position: layout === 'radial' ? ('inside' as const) : ('right' as const), verticalAlign: 'middle' as const, align: layout === 'radial' ? ('center' as const) : ('left' as const), distance: 6, }, leaves: { label: { position: layout === 'radial' ? ('inside' as const) : ('right' as const) }, }, lineStyle: { color: axisColor, width: 1.5, curveness: 0.5 }, emphasis: { focus: 'descendant' as const }, itemStyle: { color: colors[0], borderColor: colors[0] }, }, ] const userOption: any = option ?? {} const { series: userSeries, ...userRest } = userOption const mergedSeries = Array.isArray(userSeries) ? series.map((s, i) => ({ ...s, ...(userSeries[i] ?? {}) })) : series return { color: colors, tooltip: { trigger: 'item', backgroundColor: getChartTooltipBg(), borderColor: getChartTooltipBorder(), textStyle: { color: getChartTooltipText(), fontSize: 12 }, }, series: mergedSeries, ...userRest, } }) const heightStyle = $derived(/^\d+$/.test(String(height)) ? `${height}px` : String(height)) let container = $state<HTMLDivElement | null>(null) let chart: ECharts | null = null onMount(() => { if (!container) return const c = init(container) chart = c c.setOption(mergedOption) const ro = new ResizeObserver(() => c.resize()) ro.observe(container) return () => { ro.disconnect() c.dispose() chart = null } }) $effect(() => { const opt = mergedOption chart?.setOption(opt) }) </script> <div bind:this={ref} data-uipkge data-slot="tree-chart" role="img" aria-label={ariaLabel || 'Chart'} style="height: {heightStyle}" class={cn('w-full', className)} {...restProps} > <div bind:this={container} class="size-full"></div> </div>src/lib/components/ui/tree-chart/chart-theme.ts4.9 kB
// Self-contained chart theme helpers (the Vue twin reads these from the shared // `components/ui/charts/useChartTheme.ts`; each Svelte chart ships its own copy // so the install unit stays dependency-free apart from `echarts`). // // The palette is driven by Tailwind v4 CSS variables (`--chart-1..5`, // `--muted-foreground`, `--border`, `--popover`, etc.) so dark/light flips // happen automatically when the consumer toggles their theme class. Values // resolve at runtime via `getComputedStyle`. The component bumps a local // `themeKey` whenever `<html>` class/style changes so its derived option // re-resolves and the chart re-paints. // 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 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') }src/lib/components/ui/tree-chart/index.ts0.1 kB
export { default as TreeChart, type TreeChartProps, type TreeChartNode } from './TreeChart.svelte'
Raw manifest:https://uipkge.dev/r/svelte/tree-chart.json