Graflume · Alpha

Timeline / Range

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

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

Basic implementation

The smallest runnable chart

Start with only the required data and family encoding. Expand the code to run the same example.

Basic example

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

StatusLoading

minimal-implementation

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.

Basic example · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

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

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "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

{
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Common features

Features shared by every chart

Use the tabs to compare header, tooltip, theme, legend, highlight, callout, selection, view controls, and accessibility one feature at a time. Hover over a data mark. On supported charts, move the pointer along the axis to see the nearest value. All exact values are available in the table below.

Header

Add a chart title and supporting description inside the visualization.

StatusLoading

header

Graflume.timeline() Canvas 2D

Control help

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.

Header · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Add a chart title and supporting description inside the visualization.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "title": {
    "subtitle": "Timeline uses runnable data and options to demonstrate Gantt; lane packing and grouping.",
    "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

{
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "title": {
    "subtitle": "Timeline uses runnable data and options to demonstrate Gantt; lane packing and grouping.",
    "text": "Timeline / Range"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Reveal exact values from a mark or axis position. Authors can choose locale-aware date/time styles and a time zone with declarative options.

StatusLoading

tooltip

Graflume.timeline() Canvas 2D

Control help

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.

Tooltip · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Reveal exact values from a mark or axis position. Authors can choose locale-aware date/time styles and a time zone with declarative options.

Browser API · Portable schema

Browser API

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "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 · Tooltip",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
};

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

Portable schema

{
  "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 · Tooltip",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Theme

Apply the current built-in theme from the selector and update every active example together.

StatusLoading

theme

Graflume.timeline() Canvas 2D

Control help

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.

Theme · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Apply the current built-in theme from the selector and update every active example together.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "theme": "graflume-light",
  "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

{
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "theme": "graflume-light",
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Legend

Explain the visual meaning of layers, categories, or continuous values.

StatusLoading

legend

Legend: legend · layers · one series

Graflume.timeline() Canvas 2D

Control help

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.

Legend · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Explain the visual meaning of layers, categories, or continuous values.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "legend": {
    "interactive": true,
    "items": [
      {
        "id": "series",
        "label": "Timeline / Range · Legend",
        "layerId": "layer-0"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Timeline / Range · Legend",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "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

{
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "legend": {
    "interactive": true,
    "items": [
      {
        "id": "series",
        "label": "Timeline / Range · Legend",
        "layerId": "layer-0"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Timeline / Range · Legend",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Highlight

Emphasize a representative datum or spatial position to guide inspection.

StatusLoading

highlight

Point and range highlights: highlights[] · datum · category

Graflume.timeline() Canvas 2D

Control help

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.

Highlight · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Emphasize a representative datum or spatial position to guide inspection.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      }
    }
  ],
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "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

{
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      }
    }
  ],
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Callout

Show an explanatory callout with automatic collision avoidance and multilingual wrapping.

StatusLoading

callout

Custom callouts: annotations[] · datum · category · callout · placement:auto

Graflume.timeline() Canvas 2D

Control help

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.

Callout · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Show an explanatory callout with automatic collision avoidance and multilingual wrapping.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      },
      "text": "Point and range highlights · 2026-01-19"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      }
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "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

{
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      },
      "text": "Point and range highlights · 2026-01-19"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      }
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Selection

Select and toggle data, then clear it from the background or Escape key.

StatusLoading

selection

Interactive selection: selection · multiple · toggle

Graflume.timeline() Canvas 2D

Control help

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.

Selection · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Select and toggle data, then clear it from the background or Escape key.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "selection": {
      "ariaLabel": "Interactive selection",
      "clearOnBackground": true,
      "clearOnEscape": true,
      "highlight": {
        "padding": 5
      },
      "key": "category",
      "mode": "multiple",
      "toggle": true
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "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

{
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "selection": {
      "ariaLabel": "Interactive selection",
      "clearOnBackground": true,
      "clearOnEscape": true,
      "highlight": {
        "padding": 5
      },
      "key": "category",
      "mode": "multiple",
      "toggle": true
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

View controls

Show or hide zoom, pan, reset, projection, fullscreen, and PNG export one menu at a time. Set controls: false to remove the entire toolbar.

StatusLoading

controls

Graflume.timeline() Canvas 2D

Control help

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.

View controls · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Show or hide zoom, pan, reset, projection, fullscreen, and PNG export one menu at a time. Set controls: false to remove the entire toolbar.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "top": 52
  },
  "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

{
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "top": 52
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Accessibility

Pair ARIA descriptions and keyboard guidance with a semantic data table.

StatusLoading

accessibility

Graflume.timeline() Canvas 2D

Control help

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.

Accessibility · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Pair ARIA descriptions and keyboard guidance with a semantic data table.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "accessibility": {
    "description": "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.",
    "label": "Timeline / Range · Accessibility example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "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": "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.",
    "label": "Timeline / Range · Accessibility example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "height": 620,
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Chart-specific features

Every executable mode in this family

These tabs come from Graflume's public catalog. Every mode owns runnable data, options, a Quick API, and source-backed feature claims.

Gantt chart

Gantt chart uses runnable data and options to demonstrate interval and x-range; basic dependencies.

StatusLoading

gantt
interval and x-range
basic dependencies
clipping and duration

Graflume.gantt() Canvas 2D

Control help

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.

Gantt chart · Row data
`start`temporal	`task`ordinal	`id`ordinal	`end`temporal	`progress`quantitative
2026-01-01	Research	research	2026-01-09	100
2026-01-05	Data design	data	2026-01-16	100
2026-01-12	Prototype	prototype	2026-01-25	86
2026-01-19	Accessibility	accessibility	2026-02-02	72
2026-01-27	Validation	validation	2026-02-10	48
2026-02-09	Release	release	2026-02-14	20

Gantt chart uses runnable data and options to demonstrate interval and x-range; basic dependencies.

Browser API · Portable schema

Browser API

Graflume.gantt()

const data = [
  {
    "end": "2026-01-09",
    "id": "research",
    "progress": 100,
    "start": "2026-01-01",
    "task": "Research"
  },
  {
    "end": "2026-01-16",
    "id": "data",
    "progress": 100,
    "start": "2026-01-05",
    "task": "Data design"
  },
  {
    "end": "2026-01-25",
    "id": "prototype",
    "progress": 86,
    "start": "2026-01-12",
    "task": "Prototype"
  },
  {
    "end": "2026-02-02",
    "id": "accessibility",
    "progress": 72,
    "start": "2026-01-19",
    "task": "Accessibility"
  },
  {
    "end": "2026-02-10",
    "id": "validation",
    "progress": 48,
    "start": "2026-01-27",
    "task": "Validation"
  },
  {
    "end": "2026-02-14",
    "id": "release",
    "progress": 20,
    "start": "2026-02-09",
    "task": "Release"
  }
];

const options = {
  "accessibility": {
    "description": "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.",
    "label": "Timeline / Range example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "axis": "y",
      "fields": [
        {
          "dateStyle": "long",
          "field": "start",
          "format": "date",
          "label": "Start",
          "timeZone": "UTC"
        },
        {
          "field": "task",
          "format": "auto",
          "label": "Task"
        },
        {
          "field": "id",
          "format": "auto",
          "label": "Id"
        },
        {
          "dateStyle": "long",
          "field": "end",
          "format": "date",
          "label": "End",
          "timeZone": "UTC"
        },
        {
          "field": "progress",
          "format": "number",
          "label": "Progress"
        }
      ],
      "title": "Timeline / Range",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end",
      "id": "id",
      "progress": "progress"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Gantt chart uses runnable data and options to demonstrate interval and x-range; basic dependencies.",
    "text": "Timeline / Range"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "task",
    "title": "Workstream",
    "type": "ordinal"
  }
};

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

Portable schema

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "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.",
    "label": "Timeline / Range example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "tooltip": {
      "axis": "y",
      "fields": [
        {
          "dateStyle": "long",
          "field": "start",
          "format": "date",
          "label": "Start",
          "timeZone": "UTC"
        },
        {
          "field": "task",
          "format": "auto",
          "label": "Task"
        },
        {
          "field": "id",
          "format": "auto",
          "label": "Id"
        },
        {
          "dateStyle": "long",
          "field": "end",
          "format": "date",
          "label": "End",
          "timeZone": "UTC"
        },
        {
          "field": "progress",
          "format": "number",
          "label": "Progress"
        }
      ],
      "title": "Timeline / Range",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end",
      "id": "id",
      "progress": "progress"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Gantt chart uses runnable data and options to demonstrate interval and x-range; basic dependencies.",
    "text": "Timeline / Range"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "task",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Timeline

Timeline uses runnable data and options to demonstrate Gantt; lane packing and grouping.

StatusLoading

timeline
Gantt
lane packing and grouping
navigator

Graflume.timeline() Canvas 2D

Control help

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.

Timeline · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Timeline uses runnable data and options to demonstrate Gantt; lane packing and grouping.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "accessibility": {
    "description": "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.",
    "label": "Timeline / Range · Timeline example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "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 · Timeline",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Timeline uses runnable data and options to demonstrate Gantt; lane packing and grouping.",
    "text": "Timeline / Range · Timeline"
  },
  "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": "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.",
    "label": "Timeline / Range · Timeline example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "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 · Timeline",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Timeline uses runnable data and options to demonstrate Gantt; lane packing and grouping.",
    "text": "Timeline / Range · Timeline"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Horizontal range chart

Horizontal range chart uses runnable data and options to demonstrate progress bars; milestones.

StatusLoading

x-range
progress bars
milestones

Graflume.xRange() Canvas 2D

Control help

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.

Horizontal range chart · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Horizontal range chart uses runnable data and options to demonstrate progress bars; milestones.

Browser API · Portable schema

Browser API

Graflume.xRange()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

const options = {
  "accessibility": {
    "description": "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.",
    "label": "Timeline / Range · Horizontal range chart example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "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 · Horizontal range chart",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Horizontal range chart uses runnable data and options to demonstrate progress bars; milestones.",
    "text": "Timeline / Range · Horizontal range chart"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
};

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

Portable schema

ChartSpec 0.1 · options

{
  "accessibility": {
    "description": "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.",
    "label": "Timeline / Range · Horizontal range chart example"
  },
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "height": 620,
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "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 · Horizontal range chart",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Horizontal range chart uses runnable data and options to demonstrate progress bars; milestones.",
    "text": "Timeline / Range · Horizontal range chart"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

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

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.

Wide numeric range · Row data
`start`temporal	`category`ordinal	`end`temporal
1900-01-01	Research	1900-01-01
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2099-12-01	Release	2100-01-01

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"
  }
}

Sparse and irregular structure

Exercise only duplicate, missing, sparse, or out-of-order structures whose meaning is defined for this family. Broken references and malformed tuples are never disguised as successful examples. It applies 3 structural rules that preserve the meaning of missing, duplicate, and ordered values.

StatusLoading

irregular-structure
sparse
out-of-order
overlap
budget:marks<=6

Graflume.timeline() Canvas 2D

Control help

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.

Sparse and irregular structure · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-10	Prototype	2026-01-10
2026-01-01	Research	2026-01-20
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14
2026-01-05	Data design	2026-01-16

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Prototype",
    "end": "2026-01-10",
    "start": "2026-01-10"
  },
  {
    "category": "Research",
    "end": "2026-01-20",
    "start": "2026-01-01"
  },
  {
    "category": "Accessibility",
    "end": "2026-02-02",
    "start": "2026-01-19"
  },
  {
    "category": "Validation",
    "end": "2026-02-10",
    "start": "2026-01-27"
  },
  {
    "category": "Release",
    "end": "2026-02-14",
    "start": "2026-02-09"
  },
  {
    "category": "Data design",
    "end": "2026-01-16",
    "start": "2026-01-05"
  }
];

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 · Sparse and irregular structure"
  },
  "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 · Sparse and irregular structure",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "title": {
    "subtitle": "edge case · structure",
    "text": "Timeline / Range · Sparse and irregular structure"
  },
  "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 · Sparse and irregular structure"
  },
  "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 · Sparse and irregular structure",
      "trigger": "axis"
    }
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "title": {
    "subtitle": "edge case · structure",
    "text": "Timeline / Range · Sparse and irregular structure"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

High data volume

Materialize a deterministic compact recipe only when this tab opens. Graflume's performance profile bounds mark count, hit testing, and animation work for the input size. It applies 6 high-volume rules for deterministic generation and bounded output. This family materializes 60,000 logical rows and bounds rendered bar marks at 20,000.

StatusLoading

high-row-cardinality
all-input-rows-generated
all-input-rows-processed
deterministic-generation
bounded-rendering
input:60000
zoom-pan-reset
budget:bar-marks<=20000

Legend: legend · layers · one series
Point and range highlights: highlights[] · datum · category
Custom callouts: annotations[] · datum · category · callout · placement:auto

Graflume.timeline() Canvas 2D

Control help

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.

Browser API · Portable schema

Browser API

Graflume.timeline()

const recipe = {
  "cardinality": {
    "axes": {},
    "sourceRows": 60000,
    "unit": "rows"
  },
  "expectedInvariants": [
    "finite-json",
    "stable-interval-id",
    "start-not-after-end",
    "progress-closed-0-100"
  ],
  "id": "interval-sequence",
  "initialView": {
    "kind": "domain",
    "zoom": 1
  },
  "outputBudget": {
    "maximum": 20000,
    "resource": "bar-marks"
  },
  "parameters": {
    "family": "timeline",
    "nullableFields": [],
    "positiveFields": [],
    "scenario": "volume",
    "valueFields": [],
    "valuePolicy": "temporal-bounds"
  },
  "preview": {
    "maximumRows": 12,
    "method": "quantiles"
  },
  "reduction": {
    "method": "interval-window-sample",
    "stage": "sample"
  },
  "seed": 1728815126,
  "shape": "rows",
  "version": 2
};
const { data, previewRows, plan } = Graflume.materializeDemoRecipe(recipe);

const options = {
  "accessibility": {
    "description": "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.",
    "label": "Timeline / Range · High data volume"
  },
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Discover · Atlas migration · Public sector"
      },
      "text": "Point and range highlights · 2024-06-21"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "create": {
    "adaptive": {
      "environment": {
        "rowCount": 60000
      },
      "largeDataNavigation": true,
      "profiles": "auto"
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Discover · Atlas migration · Public sector"
      }
    }
  ],
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "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 · High data volume",
      "trigger": "axis"
    }
  },
  "legend": {
    "interactive": true,
    "items": [
      {
        "id": "series",
        "label": "Timeline / Range · High data volume",
        "layerId": "layer-0"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Timeline / Range · High data volume",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "top": 52
  },
  "performance": "auto",
  "theme": "graflume-light",
  "title": {
    "subtitle": "A release plan with overlapping work, progress, and a clear finish · 60,000 logical rows, screen-aware detail",
    "text": "Timeline / Range · High data volume"
  },
  "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": "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.",
    "label": "Timeline / Range · High data volume"
  },
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Discover · Atlas migration · Public sector"
      },
      "text": "Point and range highlights · 2024-06-21"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "long",
        "timeZone": "UTC",
        "type": "date"
      }
    }
  },
  "create": {
    "adaptive": {
      "environment": {
        "rowCount": 60000
      },
      "largeDataNavigation": true,
      "profiles": "auto"
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Discover · Atlas migration · Public sector"
      }
    }
  ],
  "interaction": {
    "controls": {
      "annotations": false,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "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 · High data volume",
      "trigger": "axis"
    }
  },
  "legend": {
    "interactive": true,
    "items": [
      {
        "id": "series",
        "label": "Timeline / Range · High data volume",
        "layerId": "layer-0"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Timeline / Range · High data volume",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "top": 52
  },
  "performance": "auto",
  "theme": "graflume-light",
  "title": {
    "subtitle": "A release plan with overlapping work, progress, and a clear finish · 60,000 logical rows, screen-aware detail",
    "text": "Timeline / Range · High data volume"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Extreme environments

Reconfigure for display, input, and device capability

Combine container size, input method, display capability, and user preference instead of guessing a device name. Compare mobile, watch, e-paper, monochrome, dot-matrix, and standards-based extreme environments on the same chart.

Fluid responsive

Reflow axes, legends, descriptions, and controls from the available container size.

960×540 · adaptive.profiles=responsive-fluid

zoom-reflow
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

Mobile

Prioritize 44px touch targets, tap tooltips, and collapsed secondary information on a narrow portrait screen.

390×844 · adaptive.profiles=mobile-touch

zoom-reflow
coarse-touch
virtual-keyboard
shape-rectangle
display-color
input-coarse
motion-full
renderer-canvas-spatial

Smartwatch

Keep essential marks, values, and stepped controls on a tiny or round screen, with the remaining detail reflowed below.

184×224 · adaptive.profiles=smartwatch

zoom-reflow
reduced-effects
coarse-touch
low-resource
cutout-round
shape-round
display-color
input-coarse
motion-reduced
renderer-canvas-spatial
viewport-tiny

E-book and e-paper

Prefer stable frames, strong contrast, and the data table for low-refresh e-paper displays.

758×1024 · adaptive.profiles=ebook-paper

print-paged
reduced-effects
low-resource
shape-paged
display-e-ink
input-keyboard
motion-static
renderer-canvas-spatial

Monochrome

Use strokes, markers, patterns, labels, and the table so color is never the only distinction.

640×400 · adaptive.profiles=monochrome

reduced-effects
shape-rectangle
display-monochrome
input-fine
motion-reduced
renderer-canvas-spatial

Dot-matrix display

Reduce decoration and mark density while using strong strokes, integer labels, and stepped zoom on a low-resolution display.

320×240 · adaptive.profiles=dot-matrix

zoom-reflow
reduced-effects
keyboard-switch
low-resource
shape-rectangle
display-grid
input-keyboard
motion-static
renderer-canvas-spatial
viewport-tiny

400% zoom and reflow

Reflow prose to one dimension at the 320 CSS px equivalent while retaining chart-local zoom and pan.

320×480 · adaptive.profiles=zoom-reflow

zoom-reflow
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

Foldable dual screen

Keep the chart and explanation in independent viewport segments without crossing the hinge.

720×640 · adaptive.profiles=foldable-dual

foldable-dual
shape-dual
display-color
input-fine
motion-full
renderer-canvas-spatial

TV and remote

Provide strong focus indication and D-pad, Enter, and Escape operation on a hoverless distance display.

1920×1080 · adaptive.profiles=tv-remote

tv-remote
shape-rectangle
display-color
input-remote
motion-full
renderer-canvas-spatial

Print and paged media

Pair a static chart with its description and table, hide controls, and avoid page breaks through the figure.

794×1123 · adaptive.profiles=print-paged

print-paged
shape-paged
display-color
input-fine
motion-static
renderer-canvas-spatial

Forced colors

Honor system colors and borders while retaining patterns, markers, and text as redundant cues.

640×400 · adaptive.profiles=forced-colors

forced-colors
shape-rectangle
display-high-contrast
input-fine
motion-full
renderer-canvas-spatial

Reduced effects

Complete transitions immediately and use opaque surfaces and deferred work to reduce motion and transparency load.

640×400 · adaptive.profiles=reduced-effects

reduced-effects
shape-rectangle
display-color
input-fine
motion-reduced
renderer-canvas-spatial

Coarse touch

Inspect values by tap without hover, keep targets at least 44px, and expose explicit zoom buttons.

390×844 · adaptive.profiles=coarse-touch

coarse-touch
shape-rectangle
display-color
input-coarse
motion-full
renderer-canvas-spatial

Keyboard and switch input

Reach every operation with Tab, arrows, Enter, Space, and Escape, with no drag-only action.

640×400 · adaptive.profiles=keyboard-switch

keyboard-switch
shape-rectangle
display-color
input-keyboard
motion-full
renderer-canvas-spatial

Low resource and slow network

Prefer progressive rendering, sampling, cancellable work, and a static fallback under constrained memory or connectivity.

640×400 · adaptive.profiles=low-resource

low-resource
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

RTL document

Follow RTL logical flow for prose and tabs while keeping axes, code, and data identifiers in technical LTR order.

640×400 · adaptive.profiles=rtl

rtl
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

Vertical writing

Reflow vertical prose while keeping the chart and technical surfaces in an independent horizontal panel.

640×400 · adaptive.profiles=vertical-writing

vertical-writing
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

Ultrawide and projection

Cap chart width instead of stretching indefinitely, using panelization and readable labels on ultrawide or projected surfaces.

1920×720 · adaptive.profiles=ultrawide-projection

ultrawide-projection
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

Screen reader and braille

Provide short and long descriptions, a semantic table, and status so Canvas or color is never the sole information path.

640×400 · adaptive.profiles=screenreader-braille

screenreader-braille
shape-nonvisual
display-color
input-nonvisual
motion-full
renderer-canvas-spatial

No scripting

A verified static preview, description, and collapsible row-data table preserve the essential information when scripting is unavailable.

640×400 · adaptive.profiles=no-script

no-script
shape-nonvisual
display-color
input-fine
motion-static
renderer-static-fallback

XR and see-through display

Fall back safely to the ordinary 2D or WebGL panel when XR APIs are absent, duplicating depth cues in text and the table.

640×400 · adaptive.profiles=spatial-xr

spatial-xr
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

Cutout and round display

Inset titles, marks, and controls around safe areas and round display bounds so they are not clipped.

184×224 · adaptive.profiles=cutout-round

cutout-round
shape-round
display-color
input-fine
motion-full
renderer-canvas-spatial
viewport-tiny

Virtual keyboard viewport

Reflow focus controls, the chart, and the active explanation when a virtual keyboard reduces the visual viewport.

390×560 · adaptive.profiles=virtual-keyboard

virtual-keyboard
shape-rectangle
display-color
input-fine
motion-full
renderer-canvas-spatial

Extreme environment preview

Choose a profile above to preserve the same data and ChartSpec while reconfiguring the chart for display size, input method, display capability, and user preference.

StatusLoading

adaptive
capability-driven
no-user-agent-branching

Legend: legend · layers · one series
Point and range highlights: highlights[] · datum · category
Custom callouts: annotations[] · datum · category · callout · placement:auto
Interactive selection: selection · multiple · toggle

Graflume.timeline() Canvas 2D

Control help

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.

Extreme environment preview · Row data
`start`temporal	`category`ordinal	`end`temporal
2026-01-01	Research	2026-01-09
2026-01-05	Data design	2026-01-16
2026-01-12	Prototype	2026-01-25
2026-01-19	Accessibility	2026-02-02
2026-01-27	Validation	2026-02-10
2026-02-09	Release	2026-02-14

Choose a profile above to preserve the same data and ChartSpec while reconfiguring the chart for display size, input method, display capability, and user preference.

Browser API · Portable schema

Browser API

Graflume.timeline()

const data = [
  {
    "category": "Research",
    "end": "2026-01-09",
    "start": "2026-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": "2026-02-14",
    "start": "2026-02-09"
  }
];

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: A release plan with overlapping work, progress, and a clear finish"
  },
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      },
      "text": "Point and range highlights · 2026-01-19"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "create": {
    "adaptive": {
      "profiles": "auto"
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      }
    }
  ],
  "interaction": {
    "controls": {
      "annotations": true,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "selection": {
      "ariaLabel": "Interactive selection",
      "clearOnBackground": true,
      "clearOnEscape": true,
      "highlight": {
        "padding": 5
      },
      "key": "category",
      "mode": "multiple",
      "toggle": 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"
    }
  },
  "legend": {
    "interactive": true,
    "items": [
      {
        "id": "series",
        "label": "Timeline / Range",
        "layerId": "layer-0"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Timeline / Range",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "A release plan with overlapping work, progress, and a clear finish",
    "text": "Timeline"
  },
  "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: A release plan with overlapping work, progress, and a clear finish"
  },
  "annotations": [
    {
      "connector": {
        "visible": true
      },
      "detail": "Attach user-authored safe text to a datum, axis range, or normalized plot position.",
      "id": "manual-callout",
      "placement": "auto",
      "style": {
        "maxWidth": 220,
        "padding": 8
      },
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      },
      "text": "Point and range highlights · 2026-01-19"
    }
  ],
  "axes": {
    "x": {
      "format": {
        "dateStyle": "medium",
        "timeZone": "UTC",
        "type": "date"
      },
      "ticks": {
        "count": 5,
        "spacing": 10
      }
    },
    "y": {
      "labels": {
        "maxLength": 22,
        "orientation": "horizontal",
        "padding": 12
      },
      "title": {
        "padding": 86,
        "text": "Workstream"
      }
    }
  },
  "create": {
    "adaptive": {
      "profiles": "auto"
    }
  },
  "height": 620,
  "highlights": [
    {
      "id": "manual-focus",
      "padding": 7,
      "target": {
        "field": "category",
        "type": "datum",
        "value": "Accessibility"
      }
    }
  ],
  "interaction": {
    "controls": {
      "annotations": true,
      "export": true,
      "fullscreen": true,
      "labels": {
        "controls": "Chart controls",
        "enterFullscreen": "Enter fullscreen",
        "exitFullscreen": "Exit fullscreen",
        "exportPng": "Download PNG",
        "hideAnnotations": "Hide callouts",
        "loop": "Loop playback",
        "nextFrame": "Next frame",
        "pause": "Pause",
        "play": "Play",
        "previousFrame": "Previous frame",
        "reset": "Reset view",
        "seek": "Playback position",
        "showAnnotations": "Show callouts",
        "speed": "Playback speed",
        "zoomIn": "Zoom in",
        "zoomOut": "Zoom out"
      },
      "playback": false,
      "reset": true,
      "zoom": true
    },
    "hover": true,
    "navigation": {
      "drag": true,
      "keyboard": true,
      "maxZoom": 6,
      "minZoom": 1,
      "pinch": true,
      "wheel": "modifier"
    },
    "selection": {
      "ariaLabel": "Interactive selection",
      "clearOnBackground": true,
      "clearOnEscape": true,
      "highlight": {
        "padding": 5
      },
      "key": "category",
      "mode": "multiple",
      "toggle": 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"
    }
  },
  "legend": {
    "interactive": true,
    "items": [
      {
        "id": "series",
        "label": "Timeline / Range",
        "layerId": "layer-0"
      }
    ],
    "labels": {
      "hide": "Hide",
      "show": "Show"
    },
    "maxItems": 8,
    "mode": "layers",
    "orientation": "horizontal",
    "position": "bottom",
    "title": "Timeline / Range",
    "visible": true
  },
  "locale": "en",
  "mark": {
    "fields": {
      "end": "end"
    }
  },
  "padding": {
    "bottom": 64,
    "left": 132,
    "right": 30,
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "A release plan with overlapping work, progress, and a clear finish",
    "text": "Timeline"
  },
  "width": "container",
  "x": {
    "field": "start",
    "title": "Schedule",
    "type": "temporal"
  },
  "y": {
    "field": "category",
    "title": "Workstream",
    "type": "ordinal"
  }
}

Catalog

Modes · compatibility identifiers

The source-controlled catalog maps callable modes in this family and compatibility identifiers to their canonical modes. This table contains executable entries only.

Mode / compatibility ID search

3 modes · 3 compatibility identifiers

Timeline / Range · supported modes · representative `timeline`
ID	Name	Quick API	mode	mark	renderer
`gantt`	Gantt chart	`gantt()`	`gantt`	`gantt`	`canvas`
`timeline`	Timeline	`timeline()`	`default`	`timeline`	`canvas`
`x-range`	Horizontal range chart	`xRange()`	`x-range`	`timeline`	`canvas`

Timeline / Range · compatibility identifiers
Identifier	Canonical mode ID
`gantt`	`gantt`
`timeline`	`timeline`
`xrange`	`x-range`

ChartSpec · SpatialSpec

Legend and emphasis

Identify series, emphasize a datum or range, place a custom callout, and let readers select marks.

Legend: Explain the series and scale represented by each color, line, or symbol inside the chart.
Point and range highlights: Emphasize a datum, value set, axis interval, or plot region without changing source values.
Custom callouts: Attach user-authored safe text to a datum, axis range, or normalized plot position. 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.
Interactive selection: Click a mark to select it, press Escape to clear it, and consume selection state and events in the host application.

Manual

Integration checklist

ARIA · table fallback

Accessibility

Canvas ARIA metadata is paired with a text summary and table fallback.

standard · large · ultra

Performance

Standard, large, and ultra profiles bound rendering work.

Chart catalog