- Prop
data- Type
readonly IsoRidgeTerrainDatum[]- Default
- —
- Requirement
- required
- Description
- —
IsoRidgeTerrainChart
React example follows below.
Vue example follows below.
Angular example follows below.
Svelte example follows below.
Solid example follows below.
- surface
- —
- marks
- —
- size
- —
- value
- —
ts
function ridge(label: string, start: number, step: number) { const values = Array.from({ length: 28 }, (_, index) => { const weekday = index % 7; const weekend = weekday === 5 || weekday === 6; const wave = Math.round(start + step * Math.sin(index / 3.2) + index * 0.8); return weekend ? Math.round(wave * 0.68) : wave; }); return { label, values };} const isoRidgeTerrainChartFixture = { id: "iso-ridge-terrain-chart", ariaLabel: "Daily support ticket volume by regional team over four weeks", data: [ ridge("London", 92, 14), ridge("Manchester", 62, 11), ridge("Bristol", 41, 8), ridge("Glasgow", 48, 9), ridge("Belfast", 29, 6), ridge("Cardiff", 35, 7), ridge("Leeds", 54, 10), ridge("Edinburgh", 38, 7), ],}; import { IsoRidgeTerrainChart } from "@grassroot/charts-react"; export default function IsoRidgeTerrainChartDemo() { return ( <div> <IsoRidgeTerrainChart {...isoRidgeTerrainChartFixture} /> </div> );}- surface
- —
- marks
- —
- size
- —
- value
- —
ts
<script setup lang="ts">function ridge(label: string, start: number, step: number) { const values = Array.from({ length: 28 }, (_, index) => { const weekday = index % 7; const weekend = weekday === 5 || weekday === 6; const wave = Math.round(start + step * Math.sin(index / 3.2) + index * 0.8); return weekend ? Math.round(wave * 0.68) : wave; }); return { label, values };} const isoRidgeTerrainChartFixture = { id: "iso-ridge-terrain-chart", ariaLabel: "Daily support ticket volume by regional team over four weeks", data: [ ridge("London", 92, 14), ridge("Manchester", 62, 11), ridge("Bristol", 41, 8), ridge("Glasgow", 48, 9), ridge("Belfast", 29, 6), ridge("Cardiff", 35, 7), ridge("Leeds", 54, 10), ridge("Edinburgh", 38, 7), ],}; import { IsoRidgeTerrainChart } from "@grassroot/charts-vue";</script> <template><IsoRidgeTerrainChart v-bind="isoRidgeTerrainChartFixture" /></template>- surface
- —
- marks
- —
- size
- —
- value
- —
ts
import { ChangeDetectionStrategy, Component } from "@angular/core";function ridge(label: string, start: number, step: number) { const values = Array.from({ length: 28 }, (_, index) => { const weekday = index % 7; const weekend = weekday === 5 || weekday === 6; const wave = Math.round(start + step * Math.sin(index / 3.2) + index * 0.8); return weekend ? Math.round(wave * 0.68) : wave; }); return { label, values };} const isoRidgeTerrainChartFixture = { id: "iso-ridge-terrain-chart", ariaLabel: "Daily support ticket volume by regional team over four weeks", data: [ ridge("London", 92, 14), ridge("Manchester", 62, 11), ridge("Bristol", 41, 8), ridge("Glasgow", 48, 9), ridge("Belfast", 29, 6), ridge("Cardiff", 35, 7), ridge("Leeds", 54, 10), ridge("Edinburgh", 38, 7), ],}; import { GrassrootIsoRidgeTerrainChart } from "@grassroot/charts-angular"; @Component({ selector: "app-iso-ridge-terrain-chart-demo", standalone: true, imports: [GrassrootIsoRidgeTerrainChart], changeDetection: ChangeDetectionStrategy.OnPush, template: `<grassroot-iso-ridge-terrain-chart [data]="fixture.data" [ariaLabel]="fixture.ariaLabel" />`,})export class IsoRidgeTerrainChartDemoComponent { readonly fixture = isoRidgeTerrainChartFixture;} export default IsoRidgeTerrainChartDemoComponent;- surface
- —
- marks
- —
- size
- —
- value
- —
ts
<script lang="ts"> function ridge(label: string, start: number, step: number) { const values = Array.from({ length: 28 }, (_, index) => { const weekday = index % 7; const weekend = weekday === 5 || weekday === 6; const wave = Math.round(start + step * Math.sin(index / 3.2) + index * 0.8); return weekend ? Math.round(wave * 0.68) : wave; }); return { label, values }; } const isoRidgeTerrainChartFixture = { id: "iso-ridge-terrain-chart", ariaLabel: "Daily support ticket volume by regional team over four weeks", data: [ ridge("London", 92, 14), ridge("Manchester", 62, 11), ridge("Bristol", 41, 8), ridge("Glasgow", 48, 9), ridge("Belfast", 29, 6), ridge("Cardiff", 35, 7), ridge("Leeds", 54, 10), ridge("Edinburgh", 38, 7), ], }; import { IsoRidgeTerrainChart } from "@grassroot/charts-svelte";</script> <IsoRidgeTerrainChart {...isoRidgeTerrainChartFixture} />- surface
- —
- marks
- —
- size
- —
- value
- —
ts
/** @jsxImportSource solid-js */function ridge(label: string, start: number, step: number) { const values = Array.from({ length: 28 }, (_, index) => { const weekday = index % 7; const weekend = weekday === 5 || weekday === 6; const wave = Math.round(start + step * Math.sin(index / 3.2) + index * 0.8); return weekend ? Math.round(wave * 0.68) : wave; }); return { label, values };} const isoRidgeTerrainChartFixture = { id: "iso-ridge-terrain-chart", ariaLabel: "Daily support ticket volume by regional team over four weeks", data: [ ridge("London", 92, 14), ridge("Manchester", 62, 11), ridge("Bristol", 41, 8), ridge("Glasgow", 48, 9), ridge("Belfast", 29, 6), ridge("Cardiff", 35, 7), ridge("Leeds", 54, 10), ridge("Edinburgh", 38, 7), ],}; import { IsoRidgeTerrainChart } from "@grassroot/charts-solid"; export default function IsoRidgeTerrainChartDemo() { return <IsoRidgeTerrainChart {...isoRidgeTerrainChartFixture} />;}Installation
API Reference
Import
import { IsoRidgeTerrainChart } from "@grassroot/charts-react";
Props
Prop
Type
Default
Requirement
Description
datareadonly IsoRidgeTerrainDatum[]—
required
—
legendboolean | import("@grassroot/chart-spec").LegendConfig | undefined—
optional
—
tooltipboolean | import("./base").ExpandedChartTooltipConfig<unknown> | undefined—
optional
—
animationboolean | import("./base").ExpandedChartAnimationConfig | undefined—
optional
—
onHiddenSeriesChange((ids: readonly string[]) => void) | undefined—
optional
—
onActiveDatumChange((id: string | null) => void) | undefined—
optional
—
rendererimport("@grassroot/core").ChartRenderer | undefined—
optional
—
classNamestring | undefined—
optional
—
themeimport("@grassroot/theme").PartialChartTheme | undefined—
optional
—
titlestring | undefined—
optional
—
descriptionstring | undefined—
optional
—
ariaLabelstring | undefined—
optional
—
widthnumber | undefined—
optional
—
- Prop
legend- Type
boolean | import("@grassroot/chart-spec").LegendConfig | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
tooltip- Type
boolean | import("./base").ExpandedChartTooltipConfig<unknown> | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
animation- Type
boolean | import("./base").ExpandedChartAnimationConfig | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
onHiddenSeriesChange- Type
((ids: readonly string[]) => void) | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
onActiveDatumChange- Type
((id: string | null) => void) | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
renderer- Type
import("@grassroot/core").ChartRenderer | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
className- Type
string | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
theme- Type
import("@grassroot/theme").PartialChartTheme | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
title- Type
string | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
description- Type
string | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
ariaLabel- Type
string | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
keyboardNavigation- Type
boolean | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
width- Type
number | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
height- Type
number | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
gpuBackend- Type
import("@grassroot/core").ChartGpuBackend | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
rendererStrategy- Type
Partial<import("@grassroot/core").ChartRendererStrategy> | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
renderPlanMode- Type
"svg" | "host" | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
showGrid- Type
boolean | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
interactive- Type
boolean | undefined- Default
- —
- Requirement
- optional
- Description
- Gates every pointer/keyboard interaction the shell owns (hit-test on pointer move, focus-to-first, arrow navigation, Escape) and, with `keyboardNavigation`, whether the plot surface is focusable at all.
- Prop
hiddenSeries- Type
readonly string[] | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
defaultHiddenSeries- Type
readonly string[] | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
activeDatum- Type
string | null | undefined- Default
- —
- Requirement
- optional
- Description
- —
- Prop
defaultActiveDatum- Type
string | null | undefined- Default
- —
- Requirement
- optional
- Description
- Uncontrolled initial value for the `activeDatum`/`onActiveDatumChange` pair.
- Prop
speed- Type
number | undefined- Default
- —
- Requirement
- optional
- Description
- Playback-speed multiplier for entrance/ambient motion.
- Prop
morphDurationMs- Type
number | undefined- Default
- —
- Requirement
- optional
- Description
- How long a dataset change tweens, in milliseconds.
- Prop
replayToken- Type
string | number | undefined- Default
- —
- Requirement
- optional
- Description
- Changing this value replays the entrance animation.
Events
| Event | Payload |
|---|---|
onHiddenSeriesChange | ((ids: readonly string[]) => void) | undefined |
onActiveDatumChange | ((id: string | null) => void) | undefined |
Content regions
dataSummary
Native attributes
Standard DOM and ARIA attributes not listed above spread onto the root element.
Import
import { IsoRidgeTerrainChart } from "@grassroot/charts-vue";
Props
Prop
Type
Default
Requirement
datareadonly IsoRidgeTerrainDatum[]—
required
widthnumber | undefined—
optional
heightnumber | undefined—
optional
showGridboolean | undefined—
optional
ariaLabelstring | undefined—
optional
titlestring | undefined—
optional
descriptionstring | undefined—
optional
classNamestring | undefined—
optional
rendererChartRenderer | undefined—
optional
gpuBackend"auto" | "webgpu" | "webgl2" | undefined—
optional
rendererStrategyPartial<ChartRendererStrategy> | undefined—
optional
renderPlanMode"svg" | "host" | undefined"host"optional
themePartialChartTheme | undefined—
optional
animationChartAnimationInput | undefined—
optional
- Prop
data- Type
readonly IsoRidgeTerrainDatum[]- Default
- —
- Requirement
- required
- Prop
width- Type
number | undefined- Default
- —
- Requirement
- optional
- Prop
height- Type
number | undefined- Default
- —
- Requirement
- optional
- Prop
showGrid- Type
boolean | undefined- Default
- —
- Requirement
- optional
- Prop
ariaLabel- Type
string | undefined- Default
- —
- Requirement
- optional
- Prop
title- Type
string | undefined- Default
- —
- Requirement
- optional
- Prop
description- Type
string | undefined- Default
- —
- Requirement
- optional
- Prop
className- Type
string | undefined- Default
- —
- Requirement
- optional
- Prop
renderer- Type
ChartRenderer | undefined- Default
- —
- Requirement
- optional
- Prop
gpuBackend- Type
"auto" | "webgpu" | "webgl2" | undefined- Default
- —
- Requirement
- optional
- Prop
rendererStrategy- Type
Partial<ChartRendererStrategy> | undefined- Default
- —
- Requirement
- optional
- Prop
renderPlanMode- Type
"svg" | "host" | undefined- Default
"host"- Requirement
- optional
- Prop
theme- Type
PartialChartTheme | undefined- Default
- —
- Requirement
- optional
- Prop
animation- Type
ChartAnimationInput | undefined- Default
- —
- Requirement
- optional
- Prop
interactive- Type
boolean | undefined- Default
true- Requirement
- optional
- Prop
keyboardNavigation- Type
boolean | undefined- Default
true- Requirement
- optional
- Prop
tooltip- Type
boolean | TooltipBehaviorConfig | undefined- Default
true- Requirement
- optional
- Prop
legend- Type
boolean | LegendConfig | undefined- Default
false- Requirement
- optional
- Prop
hiddenSeries- Type
readonly string[] | undefined- Default
- —
- Requirement
- optional
- Prop
defaultHiddenSeries- Type
readonly string[] | undefined- Default
() => []- Requirement
- optional
- Prop
activeDatum- Type
string | null | undefined- Default
- —
- Requirement
- optional
- Prop
defaultActiveDatum- Type
string | null | undefined- Default
- —
- Requirement
- optional
- Prop
speed- Type
number | undefined- Default
- —
- Requirement
- optional
- Prop
morphDurationMs- Type
number | undefined- Default
- —
- Requirement
- optional
- Prop
replayToken- Type
string | number | undefined- Default
- —
- Requirement
- optional
Events
| Event | Payload |
|---|---|
hiddenSeriesChange | [ids: readonly string[]] |
activeDatumChange | [id: string | null] |
Content regions
dataSummary
Import
import { ChangeDetectionStrategy, Component } from "@angular/core";
import { GrassrootIsoRidgeTerrainChart } from "@grassroot/charts-angular";
Props
Prop
Type
Default
Requirement
rendererChartRenderer—
optional
gpuBackendChartGpuBackend—
optional
rendererStrategyPartial<ChartRendererStrategy>—
optional
renderPlanMode"svg" | "host""host"optional
ariaLabelstring—
optional
titlestring—
optional
descriptionstring—
optional
themePartialChartTheme—
optional
animationChartAnimationInput—
optional
interactivebooleantrueoptional
tooltipboolean | TooltipBehaviorConfigtrueoptional
legendboolean | LegendConfig—
optional
- Prop
renderer- Type
ChartRenderer- Default
- —
- Requirement
- optional
- Prop
gpuBackend- Type
ChartGpuBackend- Default
- —
- Requirement
- optional
- Prop
rendererStrategy- Type
Partial<ChartRendererStrategy>- Default
- —
- Requirement
- optional
- Prop
renderPlanMode- Type
"svg" | "host"- Default
"host"- Requirement
- optional
- Prop
ariaLabel- Type
string- Default
- —
- Requirement
- optional
- Prop
title- Type
string- Default
- —
- Requirement
- optional
- Prop
description- Type
string- Default
- —
- Requirement
- optional
- Prop
theme- Type
PartialChartTheme- Default
- —
- Requirement
- optional
- Prop
animation- Type
ChartAnimationInput- Default
- —
- Requirement
- optional
- Prop
interactive- Type
boolean- Default
true- Requirement
- optional
- Prop
keyboardNavigation- Type
boolean- Default
true- Requirement
- optional
- Prop
tooltip- Type
boolean | TooltipBehaviorConfig- Default
true- Requirement
- optional
- Prop
legend- Type
boolean | LegendConfig- Default
- —
- Requirement
- optional
- Prop
hiddenSeries- Type
readonly string[]- Default
- —
- Requirement
- optional
- Prop
defaultHiddenSeries- Type
readonly string[]- Default
[]- Requirement
- optional
- Prop
activeDatum- Type
string | null- Default
- —
- Requirement
- optional
- Prop
defaultActiveDatum- Type
string | null- Default
null- Requirement
- optional
- Prop
speed- Type
number- Default
- —
- Requirement
- optional
- Prop
morphDurationMs- Type
number- Default
- —
- Requirement
- optional
- Prop
replayToken- Type
string | number- Default
- —
- Requirement
- optional
- Prop
width- Type
number- Default
- —
- Requirement
- optional
- Prop
height- Type
number- Default
- —
- Requirement
- optional
- Prop
showGrid- Type
boolean- Default
- —
- Requirement
- optional
- Prop
className- Type
string- Default
- —
- Requirement
- optional
- Prop
data- Type
readonly IsoRidgeTerrainDatum[]- Default
- —
- Requirement
- required
Events
| Event | Payload |
|---|---|
activeDatumChange | string | null |
hiddenSeriesChange | readonly string[] |
Content regions
dataSummary
Import
import { IsoRidgeTerrainChart } from "@grassroot/charts-svelte";
Props
Prop
Type
Default
Requirement
datareadonly IsoRidgeTerrainDatum[]—
required
widthnumber—
optional
heightnumber—
optional
showGridboolean—
optional
rendererChartRenderer—
optional
gpuBackendChartGpuBackend—
optional
rendererStrategyPartial<ChartRendererStrategy>—
optional
renderPlanMode"svg" | "host"—
optional
ariaLabelstring—
optional
legendboolean | LegendConfig—
optional
tooltipboolean | TooltipBehaviorConfig—
optional
activeDatumstring | null—
optional
defaultActiveDatumstring | null—
optional
onActiveDatumChange(id: string | null) => void—
optional
- Prop
data- Type
readonly IsoRidgeTerrainDatum[]- Default
- —
- Requirement
- required
- Prop
width- Type
number- Default
- —
- Requirement
- optional
- Prop
height- Type
number- Default
- —
- Requirement
- optional
- Prop
showGrid- Type
boolean- Default
- —
- Requirement
- optional
- Prop
renderer- Type
ChartRenderer- Default
- —
- Requirement
- optional
- Prop
gpuBackend- Type
ChartGpuBackend- Default
- —
- Requirement
- optional
- Prop
rendererStrategy- Type
Partial<ChartRendererStrategy>- Default
- —
- Requirement
- optional
- Prop
renderPlanMode- Type
"svg" | "host"- Default
- —
- Requirement
- optional
- Prop
ariaLabel- Type
string- Default
- —
- Requirement
- optional
- Prop
legend- Type
boolean | LegendConfig- Default
- —
- Requirement
- optional
- Prop
tooltip- Type
boolean | TooltipBehaviorConfig- Default
- —
- Requirement
- optional
- Prop
activeDatum- Type
string | null- Default
- —
- Requirement
- optional
- Prop
defaultActiveDatum- Type
string | null- Default
- —
- Requirement
- optional
- Prop
onActiveDatumChange- Type
(id: string | null) => void- Default
- —
- Requirement
- optional
- Prop
hiddenSeries- Type
readonly string[]- Default
- —
- Requirement
- optional
- Prop
defaultHiddenSeries- Type
readonly string[]- Default
- —
- Requirement
- optional
- Prop
onHiddenSeriesChange- Type
(ids: readonly string[]) => void- Default
- —
- Requirement
- optional
- Prop
title- Type
string- Default
- —
- Requirement
- optional
- Prop
description- Type
string- Default
- —
- Requirement
- optional
- Prop
interactive- Type
boolean- Default
- —
- Requirement
- optional
- Prop
keyboardNavigation- Type
boolean- Default
- —
- Requirement
- optional
- Prop
theme- Type
PartialChartTheme- Default
- —
- Requirement
- optional
- Prop
animation- Type
ChartAnimationInput- Default
- —
- Requirement
- optional
- Prop
speed- Type
number- Default
- —
- Requirement
- optional
- Prop
morphDurationMs- Type
number- Default
- —
- Requirement
- optional
- Prop
replayToken- Type
string | number- Default
- —
- Requirement
- optional
- Prop
class- Type
string- Default
- —
- Requirement
- optional
- Prop
style- Type
string- Default
- —
- Requirement
- optional
Events
| Event | Payload |
|---|---|
onActiveDatumChange | (id: string | null) => void |
onHiddenSeriesChange | (ids: readonly string[]) => void |
Content regions
dataSummary
Import
import { IsoRidgeTerrainChart } from "@grassroot/charts-solid";
Props
Prop
Type
Default
Requirement
datareadonly IsoRidgeTerrainDatum[]—
required
onActiveDatumChange(id: string | null) => void—
optional
onHiddenSeriesChange(ids: readonly string[]) => void—
optional
classstring—
optional
styleJSX.CSSProperties—
optional
widthnumber—
optional
heightnumber—
optional
rendererChartRenderer—
optional
gpuBackendChartGpuBackend—
optional
rendererStrategyPartial<ChartRendererStrategy>—
optional
renderPlanMode"svg" | "host"—
optional
showGridboolean—
optional
legendboolean | LegendConfig—
optional
tooltipboolean | TooltipBehaviorConfig—
optional
- Prop
data- Type
readonly IsoRidgeTerrainDatum[]- Default
- —
- Requirement
- required
- Prop
onActiveDatumChange- Type
(id: string | null) => void- Default
- —
- Requirement
- optional
- Prop
onHiddenSeriesChange- Type
(ids: readonly string[]) => void- Default
- —
- Requirement
- optional
- Prop
class- Type
string- Default
- —
- Requirement
- optional
- Prop
style- Type
JSX.CSSProperties- Default
- —
- Requirement
- optional
- Prop
width- Type
number- Default
- —
- Requirement
- optional
- Prop
height- Type
number- Default
- —
- Requirement
- optional
- Prop
renderer- Type
ChartRenderer- Default
- —
- Requirement
- optional
- Prop
gpuBackend- Type
ChartGpuBackend- Default
- —
- Requirement
- optional
- Prop
rendererStrategy- Type
Partial<ChartRendererStrategy>- Default
- —
- Requirement
- optional
- Prop
renderPlanMode- Type
"svg" | "host"- Default
- —
- Requirement
- optional
- Prop
showGrid- Type
boolean- Default
- —
- Requirement
- optional
- Prop
legend- Type
boolean | LegendConfig- Default
- —
- Requirement
- optional
- Prop
tooltip- Type
boolean | TooltipBehaviorConfig- Default
- —
- Requirement
- optional
- Prop
animation- Type
ChartAnimationInput- Default
- —
- Requirement
- optional
- Prop
interactive- Type
boolean- Default
- —
- Requirement
- optional
- Prop
keyboardNavigation- Type
boolean- Default
- —
- Requirement
- optional
- Prop
hiddenSeries- Type
readonly string[]- Default
- —
- Requirement
- optional
- Prop
defaultHiddenSeries- Type
readonly string[]- Default
- —
- Requirement
- optional
- Prop
activeDatum- Type
string | null- Default
- —
- Requirement
- optional
- Prop
defaultActiveDatum- Type
string | null- Default
- —
- Requirement
- optional
- Prop
speed- Type
number- Default
- —
- Requirement
- optional
- Prop
morphDurationMs- Type
number- Default
- —
- Requirement
- optional
- Prop
replayToken- Type
string | number- Default
- —
- Requirement
- optional
- Prop
theme- Type
PartialChartTheme- Default
- —
- Requirement
- optional
- Prop
title- Type
string- Default
- —
- Requirement
- optional
- Prop
description- Type
string- Default
- —
- Requirement
- optional
- Prop
ariaLabel- Type
string- Default
- —
- Requirement
- optional
Events
| Event | Payload |
|---|---|
onActiveDatumChange | (id: string | null) => void |
onHiddenSeriesChange | (ids: readonly string[]) => void |
Content regions
dataSummary