Skip to content

PieSeries API

Extended documentation for the PieSeries interface with detailed information on the module's properties and available APIs.

Demos

Import

import { PieSeries } from '@mui/x-charts';
// or
import { PieSeries } from '@mui/x-charts-pro';
// or
import { PieSeries } from '@mui/x-charts-premium';

Properties

Type:readonly MakeOptional<PieValueType, 'id'>[]


Type:'pie'


Optional

The label displayed into the arc.

Type:| 'formattedValue' | 'label' | 'value' | ((item: Omit<DefaultizedPieValueType, 'label'> & { label?: string }) => string)


Optional

The minimal angle required to display the arc label.

Type:number

Default:0


Optional

The radius between circle center and the arc label. Can be a number (in px) or a string with a percentage such as '50%'. The '100%' is the maximal radius that fit into the drawing area.

Type:number | string

Default:(innerRadius - outerRadius) / 2


Optional

Color to use when displaying the series. If `colorGetter` is provided, it will be used to get the color for each data point instead. Otherwise, this color will be used for all data points in the series.

Type:string


Optional

A function that returns a color based on the value and/or the data index of a point. The returned color is used when displaying the specific data point, e.g., a marker in a line chart. When the color of the entire series is required, e.g., in legends, the `color` property is used instead.

Type:(data: { value: MakeOptional<PieValueType, 'id'>, dataIndex: number }) => string


Optional

The radius applied to arc corners (similar to border radius).

Type:number

Default:0


Optional

The x coordinate of the pie center. Can be a number (in px) or a string with a percentage such as '50%'. The '100%' is the width the drawing area.

Type:number | string

Default:'50%'


Optional

The y coordinate of the pie center. Can be a number (in px) or a string with a percentage such as '50%'. The '100%' is the height the drawing area.

Type:number | string

Default:'50%'


Optional

The end angle (deg) of the last item.

Type:number

Default:360


Optional

Override the arc attributes when it is faded.

Type:{ additionalRadius?: number, innerRadius?: number, outerRadius?: number, cornerRadius?: number, paddingAngle?: number, arcLabelRadius?: number, color?: string }


Optional

Override the arc attributes when it is highlighted.

Type:{ additionalRadius?: number, innerRadius?: number, outerRadius?: number, cornerRadius?: number, paddingAngle?: number, arcLabelRadius?: number, color?: string }


Optional

The scope to apply when the series is highlighted.

Type:{ highlight?: 'item' | 'none' | 'series', fade?: 'global' | 'none' | 'series' }


Optional

The id of this series.

Type:string


Optional

The radius between circle center and the beginning of the arc. Can be a number (in px) or a string with a percentage such as '50%'. The '100%' is the maximal radius that fit into the drawing area.

Type:number | string

Default:0


Optional

Defines the mark type for the series. There is a default mark type for each series type.

Type:'circle' | 'line' | 'line+mark' | 'square' | ComponentClass<ChartsLabelCustomMarkProps, any> | FunctionComponent<ChartsLabelCustomMarkProps>


Optional

The radius between circle center and the end of the arc. Can be a number (in px) or a string with a percentage such as '50%'. The '100%' is the maximal radius that fit into the drawing area.

Type:number | string

Default:'100%'


Optional

The padding angle (deg) between two arcs.

Type:number

Default:0


Optional

The sorting strategy used to order pie slices. Can be 'none', 'asc', 'desc', or a sorting function.

Type:'asc' | 'desc' | 'none' | (a: number, b: number) => number

Default:'none'


Optional

The start angle (deg) of the first item.

Type:number

Default:0


Optional

Formatter used to render values in tooltip or other data display.

Type:(value: MakeOptional<PieValueType, 'id'>, context: { dataIndex: number }) => string