Skip to content

facetCircle

Partition data by fields, use circular space division, then visualize data for each facet.

Getting Started

facetCircle
import { Chart } from '@antv/g2';

const M = [
  'Jan.',
  'Feb.',
  'Mar.',
  'Apr.',
  'May',
  'Jun.',
  'Jul.',
  'Aug.',
  'Sept.',
  'Oct.',
  'Nov.',
  'Dec.',
];
const N = ['A', 'B', 'C', 'D'];
const data = M.flatMap((month) =>
  N.map((name) => ({
    month,
    name,
    value: Math.random(),
  })),
);

const chart = new Chart({
  container: 'container',
  width: 480,
  height: 480,
});

chart.options({
  type: 'facetCircle',
  data,
  encode: { position: 'month' },
  children: [
    {
      type: 'interval',
      encode: { x: 'name', y: 'value', color: 'name' },
    },
  ],
});

chart.render();

For more examples, visit the Chart Examples page.

Options

The underlying implementation of facetCircle is consistent with mark, so many configuration options are the same.

Property Description Type Default
data Refer to data for related information Data
encode Channel settings, see table below
padding Padding size number 0
paddingLeft number 0
paddingRight number 0
paddingTop number 0
paddingBottom number 0
margin Margin number 0
marginLeft number 0
marginRight number 0
marginTop number 0
marginBottom number 0
title Refer to title for related information
scale Refer to scale for related information

All configurations corresponding to facetCircle can be set using the API, for example:

chart.options({ type: 'facetCircle', data: [1, 2, 3], encode: { position: 'month' } });

encode

For facetCircle, there are unique encode channels.

Channel Description Type Default
position Divide the angular space in the circle based on position data string | (d, idx, arr) => any
© Copyright 2026 Ant Group Co., Ltd..备案号:京ICP备15032932号-38
Site search
Documentation and examplesType to start searching

Search documentation, APIs, and examples

↑↓Select↵OpenEscClose