Graflume · Alpha

Item chart · Chart-specific features

Divide a whole into repeated symbols so category shares can be counted directly. These tabs come from Graflume's public catalog. Every mode owns runnable data, options, a Quick API, and source-backed feature claims.

Chart family · Specialized families

Item chart

Divide a whole into repeated symbols so category shares can be counted directly.

Quick API: itemChart()
Browser snapshot: graflume/complete
mark: item
Presets: 1

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.

Item chart

Item chart uses runnable data and options to demonstrate fixed waffle-like grid; proportional unit assignment.

StatusLoading

item
fixed waffle-like grid
proportional unit assignment
per-unit hit and selection
explicit waffle/isotype contract
partial units
fill direction and grouping
accessible counts

Graflume.itemChart() 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.

Item chart uses runnable data and options to demonstrate fixed waffle-like grid; proportional unit assignment.

Item chart · Row data
`category`ordinal	`value`quantitative
Organic search	38
Direct	27
Product referrals	18
Community	11
Campaigns	6

Browser API · Portable schema

Browser API

Graflume.itemChart()

const data = [
  {
    "category": "Organic search",
    "radius": 34,
    "value": 38
  },
  {
    "category": "Direct",
    "radius": 28,
    "value": 27
  },
  {
    "category": "Product referrals",
    "radius": 23,
    "value": 18
  },
  {
    "category": "Community",
    "radius": 18,
    "value": 11
  },
  {
    "category": "Campaigns",
    "radius": 13,
    "value": 6
  }
];

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": "Item chart example"
  },
  "axes": {
    "x": false,
    "y": false
  },
  "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": {
      "fields": [
        {
          "field": "category",
          "format": "auto",
          "label": "Category"
        },
        {
          "field": "value",
          "format": "number",
          "label": "Value"
        }
      ],
      "title": "Item chart",
      "trigger": "mark"
    }
  },
  "locale": "en",
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Item chart uses runnable data and options to demonstrate fixed waffle-like grid; proportional unit assignment.",
    "text": "Item chart"
  },
  "width": "container",
  "x": {
    "field": "category",
    "title": "Channel",
    "type": "ordinal"
  },
  "y": {
    "field": "value",
    "title": "Share (%)",
    "type": "quantitative"
  }
};

Graflume.itemChart('#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": "Item chart example"
  },
  "axes": {
    "x": false,
    "y": false
  },
  "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": {
      "fields": [
        {
          "field": "category",
          "format": "auto",
          "label": "Category"
        },
        {
          "field": "value",
          "format": "number",
          "label": "Value"
        }
      ],
      "title": "Item chart",
      "trigger": "mark"
    }
  },
  "locale": "en",
  "padding": {
    "top": 52
  },
  "theme": "graflume-light",
  "title": {
    "subtitle": "Item chart uses runnable data and options to demonstrate fixed waffle-like grid; proportional unit assignment.",
    "text": "Item chart"
  },
  "width": "container",
  "x": {
    "field": "category",
    "title": "Channel",
    "type": "ordinal"
  },
  "y": {
    "field": "value",
    "title": "Share (%)",
    "type": "quantitative"
  }
}

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

1 modes · 1 compatibility identifiers

Item chart · supported modes · representative `item`
ID	Name	Quick API	mode	mark	renderer
`item`	Item chart	`itemChart()`	`default`	`item`	`canvas`

Item chart · compatibility identifiers
Identifier	Canonical mode ID
`item`	`item`

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