DETAIL PANEL · DEMO

Sample project review

Keep your context while reviewing the details.

Ready for review
Template route
/felix/components/stream-chart
Project
Riverside workspace (fictitious)
Owner
Morgan Lee (fictitious)

Summary

This is an original example. The underlying page stays visible while the panel holds the details. No account, payment or external service is connected.

Review note

Skip to content

Stream chart ​

Back to Felix charts · JSON chart contract

A stream chart shows changing category amounts as the thickness of stacked bands around a moving baseline. It can reveal composition and broad patterns over an ordered sequence. It is poor for precise comparison of categories without a common baseline. Use a zero-based stack to read the total from top height, lines for independent trends or a table when exact values matter. A band below the visual center does not mean negative data.

Preview, spec and editable example ​

Stream

Fictitious local data

StreamPeriod: Jan · Primary: 35 · Secondary: 20Period: Feb · Primary: 48 · Secondary: 28

8 source rows from sample.stream. Focus a mark or a data row to read exact values.

Synthetic local data · felix-stream · sample.stream

The preview is rendered from the JSON in Spec. Open Example to edit the component, source, encoding and options, then choose Render JSON. The source registry is separately editable so you can try your own labels and values without embedding numbers in the chart spec. Nothing is sent, saved or fetched. Invalid input reports a field path and keeps the last valid preview.

Wire contract ​

This example selects felix-stream. The spec uses component, optional title, subtitle and insight, a named data.source, encoding and component-specific options. Data filters, stable sorting and limits are applied before rendering. The source holds headers and rows; every encoding names a real source column.

json
{
  "component": "felix-stream",
  "title": "Stream",
  "subtitle": "Fictitious local data",
  "data": {
    "source": "sample.stream"
  },
  "encoding": {
    "x": "Period",
    "value": "Primary",
    "secondary": "Secondary"
  },
  "options": {}
}

Encoding ​

ChannelSource column
xPeriod
valuePrimary
secondarySecondary

Options ​

This Felix extension supports highlight, max, unit, currentPeriod, weights and polarEncoding where meaningful to the selected renderer. Unused controls are not an implied API.

Data, interaction and accessibility ​

Hover, focus, click, Enter or Space on a mark to read its exact source row. Data view shows the same filtered and sorted source rows in a scrollable table. Replay motion replays the entrance; reduced motion removes it. Ready/Loading/Empty are local demonstration states only and never invent a network result. The controls and spec tabs support keyboard use, including Left/Right, Home and End in the tab list.

Felix chart colors adapt to light and dark appearance. Turquoise leads; slate supports the comparison. Highlight names, labels, a focus outline and the exact data remain available without relying only on color. Sources are local and bounded to 2,000 rows. Unknown components, sources, fields and options fail visibly. There is no HTML, JavaScript or remote URL execution in a spec.

Integration ​

vue
<script setup>
import FelixJsonChart from './FelixJsonChart.vue'
const spec = /* validated chart spec from your application */ {}
const sources = /* named local source registry */ {}
</script>

<template>
  <FelixJsonChart :spec="spec" :sources="sources" />
</template>

resolveSpec(spec, sources) validates and resolves a chart model; chartGeometry(model) derives marks from that model. The documentation wrapper owns editor drafts and the last valid preview. Your application owns data fetching, authorization, refresh/error state and persistence. This local example is not a live data service. See the contract and supported renderers before adapting production data.

Lateral detail drawer

Open a detail panel without losing the page behind it. This shared pattern follows the current template's colors. Fictitious data; actions stay local.