DETAIL PANEL · DEMO

Sample project review

Keep your context while reviewing the details.

Ready for review
Template route
/felix/components/pyramid-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

Pyramid chart ​

Back to Felix charts · JSON chart contract

A tier pyramid arranges ordered levels from narrow top to wide base. First decide whether width is a measured quantity or only a hierarchy cue. This guide uses equal-height centered bars whose full width encodes capacity on one fixed scale. It is not a filled triangular area model, a population pyramid with two signed sides, or a funnel with sequential conversion. Prefer bars for precise comparison; use a plain hierarchy list if tiers are only ordinal.

Preview, spec and editable example ​

Pyramid

Fictitious local data

PyramidCategory: North · Value: 35Category: South · Value: 25Category: East · Value: 20Category: West · Value: 10North: 35South: 25East: 20West: 10

4 source rows from sample.pyramid. Focus a mark or a data row to read exact values.

Synthetic local data · pyramid · sample.pyramid

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 pyramid. 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": "pyramid",
  "title": "Pyramid",
  "subtitle": "Fictitious local data",
  "data": {
    "source": "sample.pyramid"
  },
  "encoding": {
    "category": "Category",
    "value": "Value"
  },
  "options": {}
}

Encoding ​

ChannelSource column
categoryCategory
valueValue

Options ​

Supported contract options: unit, bracketFrom, bracketTo, bracketLabel. These are validated by component; unknown fields are rejected. This renderer supports a conservative subset and rejects options that are not implemented rather than ignoring them. See current renderer scope.

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.