Graflume · Alpha

Timeline / Range · Edge-case application

Compare the start and end of tasks or events on one time axis. Exercise numeric range, sparse structure, and large inputs with valid data. Each tab materializes data only when needed and never silently repairs invalid values.

Chart family · Default families

Timeline / Range

Compare the start and end of tasks or events on one time axis.

Quick API
timeline()
Browser snapshot
graflume
mark
timeline
Presets
3

Edge cases

Numeric range, irregular structure, and data volume

Exercise numeric range, sparse structure, and large inputs with valid data. Each tab materializes data only when needed and never silently repairs invalid values.

Wide numeric range

Mix zero, very small finite values, and very large finite values to verify automatic domains, precision, and stable geometry. NaN and Infinity remain intentionally invalid. It applies 2 data-integrity rules that preserve finite values and axis domains.

StatusLoading

  • extreme-range
  • temporal-span
  • zero-duration
  • domain-boundary
  • budget:marks<=6
Graflume.timeline() Canvas 2D
Control help

Zoom and pan inspect the rendered surface without changing data axes or values. When playback controls are available, they move through real steps in the order each unique value first appears in the source data.

Use Tab to reach a control and Enter or Space to activate it. With the chart focused, use plus and minus to zoom and arrow keys to pan.

Auto placement compares perimeter candidates and avoids the plot, legend, and other callouts when possible. Explicit placement is preserved with only necessary safety correction. Callout text wraps safely inside the bubble. Long unbroken tokens are visually shortened within the line budget, while the complete source text remains available to assistive technology.

Loading

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "1900-01-01",
    "start": "1900-01-01"
  },
  {
    "category": "Data design",
    "end": "2026-01-16",
    "start": "2026-01-05"
  },
  {
    "category": "Prototype",
    "end": "2026-01-25",
    "start": "2026-01-12"
  },
  {
    "category": "Accessibility",
    "end": "2026-02-02",
    "start": "2026-01-19"
  },
  {
    "category": "Validation",
    "end": "2026-02-10",
    "start": "2026-01-27"
  },
  {
    "category": "Release",
    "end": "2100-01-01",
    "start": "2099-12-01"
  }
];

const options = {
  "accessibility": {
    "description": "A release plan with overlapping work, progress, and a clear finish. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
    "label": "Timeline / Range"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "hover": true,
    "tooltip": {
      "axis": "y",
      "fields": [
        {
          "dateStyle": "long",
          "field": "start",
          "format": "date",
          "label": "Start",
          "timeZone": "UTC"
        },
        {
          "field": "category",
          "format": "auto",
          "label": "Category"
        },
        {
          "dateStyle": "long",
          "field": "end",
          "format": "date",
          "label": "End",
          "timeZone": "UTC"
        }
      ],
      "title": "Timeline / Range",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "title": {
    "subtitle": "edge case · range",
    "text": "Timeline / Range"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
};

Graflume.timeline('#chart', data, options);

Portable schema

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "A release plan with overlapping work, progress, and a clear finish. The example uses curated, deterministic data and exposes its exact values in a semantic table.",
    "label": "Timeline / Range"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "hover": true,
    "tooltip": {
      "axis": "y",
      "fields": [
        {
          "dateStyle": "long",
          "field": "start",
          "format": "date",
          "label": "Start",
          "timeZone": "UTC"
        },
        {
          "field": "category",
          "format": "auto",
          "label": "Category"
        },
        {
          "dateStyle": "long",
          "field": "end",
          "format": "date",
          "label": "End",
          "timeZone": "UTC"
        }
      ],
      "title": "Timeline / Range",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "title": {
    "subtitle": "edge case · range",
    "text": "Timeline / Range"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}
Chart catalog