Class PieChartWrapper

Hierarchy (View Summary)

ArcChartWrapper<"pie">
- PieChartWrapper

Implements

PieChartBuilder

Chart

build

build(id?: string): ChartConfig
Beta
Parameters
- Optionalid: string
Returns ChartConfig
Description
차트 설정 객체를 생성합니다. 이 메소드는 차트의 구성 요소를 종합하여 Chart.js에서 사용할 수 있는 형식으로 반환합니다.

Since
1.0.0
Implementation of PieChartBuilder.build
Inherited from ArcChartWrapper.build
- Defined in src/ArcChartWrapper.ts:145

Dataset

`Protected`decorateDataset

decorateDataset(ds: any, idx: number): void
Protected Beta
Parameters
- ds: any
- idx: number
Returns void
Description
데이터셋의 기본적인 옵션을 추가하거나 부여합니다. (Arc 차트용)

Returns
Since
1.0.1
Inherited from ArcChartWrapper.decorateDataset
- Defined in src/ArcChartWrapper.ts:67

highlightMaxSegment

highlightMaxSegment(offset?: number): this
Beta
Parameters
- offset: number = 10
  분리 거리 (픽셀, 기본값: 10)
Returns this
Description
가장 큰 값을 가진 세그먼트를 자동으로 분리합니다.

Since
1.0.0
Implementation of PieChartBuilder.highlightMaxSegment
- Defined in src/PieChartWrapper.ts:204

highlightMinSegment

highlightMinSegment(offset?: number): this
Beta
Parameters
- offset: number = 10
  분리 거리 (픽셀, 기본값: 10)
Returns this
Description
가장 작은 값을 가진 세그먼트를 자동으로 분리합니다.

Since
1.0.0
Implementation of PieChartBuilder.highlightMinSegment
- Defined in src/PieChartWrapper.ts:221

setAllBorderColor

setAllBorderColor(borderColor: string | string[]): this
Beta
Parameters
- borderColor: string | string[]
  경계선 색상
Returns this
Description
모든 데이터셋의 경계선 색상을 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setAllBorderColor
Overrides ArcChartWrapper.setAllBorderColor
- Defined in src/PieChartWrapper.ts:140

setAllBorderWidth

setAllBorderWidth(borderWidth: number): this
Beta
Parameters
- borderWidth: number
  경계선 너비
Returns this
Description
모든 데이터셋의 경계선 너비를 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setAllBorderWidth
Overrides ArcChartWrapper.setAllBorderWidth
- Defined in src/PieChartWrapper.ts:128

setAllSegmentOffsets

setAllSegmentOffsets(offsets: number | number[]): this
Beta
Parameters
- offsets: number | number[]
  각 세그먼트의 offset 배열 또는 모든 세그먼트에 적용할 단일 값
Returns this
Description
여러 세그먼트를 한번에 분리합니다.

Since
1.0.0
Example
```
// 각 세그먼트마다 다른 offset
chart.setAllSegmentOffsets([10, 0, 5, 0]);

// 모든 세그먼트에 동일한 offset (exploded pie chart)
chart.setAllSegmentOffsets(10);
```
Implementation of PieChartBuilder.setAllSegmentOffsets
- Defined in src/PieChartWrapper.ts:244

setBorderColor

setBorderColor(datasetIndex: number, borderColor: string | string[]): this
Beta
Parameters
- datasetIndex: number
  데이터셋 인덱스
- borderColor: string | string[]
  경계선 색상
Returns this
Description
데이터셋의 경계선 색상을 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setBorderColor
Inherited from ArcChartWrapper.setBorderColor
- Defined in src/ArcChartWrapper.ts:279

setBorderWidth

setBorderWidth(datasetIndex: number, borderWidth: number): this
Beta
Parameters
- datasetIndex: number
  데이터셋 인덱스
- borderWidth: number
  경계선 너비
Returns this
Description
데이터셋의 경계선 너비를 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setBorderWidth
Inherited from ArcChartWrapper.setBorderWidth
- Defined in src/ArcChartWrapper.ts:246

setGradientColors

setGradientColors(startColor: string, endColor: string): this
Beta
Parameters
- startColor: string
  시작 색상 (hex 형식, 예: '#FF6384')
- endColor: string
  종료 색상 (hex 형식, 예: '#36A2EB')
Returns this
Description
그라데이션 색상 팔레트를 자동으로 생성합니다.

Since
1.0.0
Implementation of PieChartBuilder.setGradientColors
- Defined in src/PieChartWrapper.ts:268

setSegmentColors

setSegmentColors(colors: string[]): this
Beta
Parameters
- colors: string[]
  색상 배열
Returns this
Description
모든 세그먼트의 색상을 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setSegmentColors
- Defined in src/PieChartWrapper.ts:58

setSegmentColorWhere

setSegmentColorWhere(
filterFn: (value: number, index: number) => boolean,
color: string,
): this
Beta
Parameters
- filterFn: (value: number, index: number) => boolean
  조건 함수
- color: string
  적용할 색상
Returns this
Description
특정 조건을 만족하는 세그먼트만 색상을 변경합니다.

Since
1.0.0
Example
```
// 값이 100 이상인 세그먼트만 빨간색으로
chart.setSegmentColorWhere((value) => value >= 100, '#FF0000');
```
Implementation of PieChartBuilder.setSegmentColorWhere
- Defined in src/PieChartWrapper.ts:289

setSegmentImages

setSegmentImages(
images: string[],
config?: Partial<Omit<SegmentImageConfig, "images">>,
): this
Beta
Parameters
- images: string[]
  이미지 URL 배열 (URL, Base64, SVG, Emoji 등)
- Optionalconfig: Partial<Omit<SegmentImageConfig, "images">>
  이미지 설정 옵션
Returns this
Description
각 세그먼트에 이미지를 설정합니다.

Since
1.6.0
Example
```
// URL 방식
chart.setSegmentImages([
  'https://example.com/icon1.png',
  'https://example.com/icon2.png'
]);

// 크기 조절
chart.setSegmentImages(
  ['image1.png', 'image2.png'],
  { width: 40, height: 40, backgroundColor: 'transparent' }
);
```
Inherited from ArcChartWrapper.setSegmentImages
- Defined in src/ArcChartWrapper.ts:324

setSegmentOffset

setSegmentOffset(dataIndex: number, offset: number): this
Beta
Parameters
- dataIndex: number
  분리할 데이터 인덱스
- offset: number
  분리 거리 (픽셀)
Returns this
Description
특정 세그먼트만 분리해서 표시합니다.

Since
1.0.0
Implementation of PieChartBuilder.setSegmentOffset
- Defined in src/PieChartWrapper.ts:74

Options

setCircumference

setCircumference(circumference: number): this
Beta
Parameters
- circumference: number
  원주각 (도 단위, 360 = 완전한 원)
Returns this
Description
차트의 원주각을 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setCircumference
Overrides ArcChartWrapper.setCircumference
- Defined in src/PieChartWrapper.ts:104

setCutout

setCutout(cutout: string | number): this
Beta
Parameters
- cutout: string | number
  구멍 크기 (퍼센트 문자열 또는 픽셀 숫자)
Returns this
Description
도넛 차트의 중앙 구멍 크기를 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setCutout
Inherited from ArcChartWrapper.setCutout
- Defined in src/ArcChartWrapper.ts:213

setHalfPieBottom

setHalfPieBottom(): this
Beta
Returns this
Description
하단 반원형 파이 차트를 생성합니다.

Since
1.0.0
Implementation of PieChartBuilder.setHalfPieBottom
- Defined in src/PieChartWrapper.ts:164

setHalfPieLeft

setHalfPieLeft(): this
Beta
Returns this
Description
좌측 반원형 파이 차트를 생성합니다.

Since
1.0.0
Implementation of PieChartBuilder.setHalfPieLeft
- Defined in src/PieChartWrapper.ts:177

setHalfPieRight

setHalfPieRight(): this
Beta
Returns this
Description
우측 반원형 파이 차트를 생성합니다.

Since
1.0.0
Implementation of PieChartBuilder.setHalfPieRight
- Defined in src/PieChartWrapper.ts:190

setHalfPieTop

setHalfPieTop(): this
Beta
Returns this
Description
상단 반원형 파이 차트를 생성합니다.

Since
1.0.0
Implementation of PieChartBuilder.setHalfPieTop
- Defined in src/PieChartWrapper.ts:151

setRadius

setRadius(radius: string | number): this
Beta
Parameters
- radius: string | number
  반지름 ('90%', '100%' 또는 픽셀값)
Returns this
Description
차트의 반지름을 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setRadius
Overrides ArcChartWrapper.setRadius
- Defined in src/PieChartWrapper.ts:116

setRotation

setRotation(rotation: number): this
Beta
Parameters
- rotation: number
  회전 각도 (도 단위)
Returns this
Description
차트의 시작 각도를 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.setRotation
Overrides ArcChartWrapper.setRotation
- Defined in src/PieChartWrapper.ts:92

Other

constructor

new PieChartWrapper(
    type: "pie",
    labels: (string | number)[],
    datasets: ChartDataset<"pie", (null | number)[]>[],
    options?: CustomPieChartOptions,
    plugins?: any,
): PieChartWrapper
Parameters
- type: "pie"
- labels: (string | number)[]
- datasets: ChartDataset<"pie", (null | number)[]>[]
- Optionaloptions: CustomPieChartOptions
- Optionalplugins: any
Returns PieChartWrapper
Overrides ArcChartWrapper.constructor
- Defined in src/PieChartWrapper.ts:23

`Protected`labels

labels: (string | number)[]

`Protected`options

options: CustomChartOptions

`Protected` `Optional`plugins

plugins?: any

`Readonly`type

type: "pie"

`Static`registry

registry: Map<string, Constructor<any, any>> = ...

chartId

get chartId(): string
Returns string
Inherited from ArcChartWrapper.chartId
- Defined in src/ArcChartWrapper.ts:39
set chartId(value: string): void
Parameters
- value: string
Returns void
Inherited from ArcChartWrapper.chartId
- Defined in src/ArcChartWrapper.ts:46

`Protected`datasets

get datasets(): CustomChartDatasets<TType>[]
Returns CustomChartDatasets<TType>[]
Inherited from ArcChartWrapper.datasets
- Defined in src/ChartWrapper.ts:44
set datasets(value: CustomChartDatasets<TType>[]): void
Parameters
- value: CustomChartDatasets<TType>[]
Returns void
Inherited from ArcChartWrapper.datasets
- Defined in src/ChartWrapper.ts:47

`Protected`configAop

configAop(config: any): any
Parameters
- config: any
Returns any
Inherited from ArcChartWrapper.configAop
- Defined in src/ArcChartWrapper.ts:105

`Private`generateGradientColors

generateGradientColors(
    startColor: string,
    endColor: string,
    steps: number,
): string[]
Private
Parameters
- startColor: string
- endColor: string
- steps: number
Returns string[]
Description
그라데이션 색상 배열을 생성합니다.
- Defined in src/PieChartWrapper.ts:332

`Private`hexToRgb

hexToRgb(hex: string): null | { b: number; g: number; r: number }
Private
Parameters
- hex: string
Returns null | { b: number; g: number; r: number }
Description
hex 색상을 RGB로 변환합니다.
- Defined in src/PieChartWrapper.ts:309

`Protected`mustHavePlugins

mustHavePlugins(): {
    _tooltips: WeakMap<WeakKey, any>;
    id: string;
    _handleGroupVisibility(chart: any, datasets: any[]): void;
    _handleLegendClick(
        e: any,
        legendItem: any,
        legend: any,
        toggleBehavior: string,
    ): void;
    _hideTooltip(chart: any): void;
    _hitTestLegend(chart: any, x: number, y: number): any;
    _setupLegendTooltip(chart: any): void;
    _showTooltip(
        chart: any,
        e: MouseEvent,
        tooltipContent: string | ((context: any) => string),
        legendItem: any,
    ): void;
    afterDestroy(chart: any): void;
    afterDraw(chart: any, args: any, options: any): void;
    afterInit(chart: any, args: any, options: any): void;
    beforeUpdate(chart: any, args: any, options: any): void;
}[]
Returns {
    _tooltips: WeakMap<WeakKey, any>;
    id: string;
    _handleGroupVisibility(chart: any, datasets: any[]): void;
    _handleLegendClick(
        e: any,
        legendItem: any,
        legend: any,
        toggleBehavior: string,
    ): void;
    _hideTooltip(chart: any): void;
    _hitTestLegend(chart: any, x: number, y: number): any;
    _setupLegendTooltip(chart: any): void;
    _showTooltip(
        chart: any,
        e: MouseEvent,
        tooltipContent: string | ((context: any) => string),
        legendItem: any,
    ): void;
    afterDestroy(chart: any): void;
    afterDraw(chart: any, args: any, options: any): void;
    afterInit(chart: any, args: any, options: any): void;
    beforeUpdate(chart: any, args: any, options: any): void;
}[]
Inherited from ArcChartWrapper.mustHavePlugins
- Defined in src/ArcChartWrapper.ts:86

`Protected`normalize

normalize(): void
Returns void
Inherited from ArcChartWrapper.normalize
- Defined in src/ArcChartWrapper.ts:90

`Protected`requireLabels

requireLabels(): boolean
Returns boolean
Overrides ArcChartWrapper.requireLabels
- Defined in src/PieChartWrapper.ts:34

`Private`rgbToHex

rgbToHex(r: number, g: number, b: number): string
Private
Parameters
- r: number
- g: number
- b: number
Returns string
Description
RGB를 hex 색상으로 변환합니다.
- Defined in src/PieChartWrapper.ts:324

`Static`create

create<TType extends keyof ChartTypeRegistry>(
    type: TType,
    labels: (string | number)[],
    datasets: CustomChartDatasets<TType>[],
    options?: CustomChartOptions<TType>,
    plugins?: Plugin<keyof ChartTypeRegistry, AnyObject>,
): TType extends keyof ChartBuilderMap
    ? ChartBuilderMap[TType<TType>]
    : ChartBuilder<TType>
Type Parameters
- TType extends keyof ChartTypeRegistry
Parameters
- type: TType
- labels: (string | number)[]
- datasets: CustomChartDatasets<TType>[]
- Optionaloptions: CustomChartOptions<TType>
- Optionalplugins: Plugin<keyof ChartTypeRegistry, AnyObject>
Returns TType extends keyof ChartBuilderMap
? ChartBuilderMap[TType<TType>]
: ChartBuilder<TType>
Inherited from ArcChartWrapper.create
- Defined in src/ChartWrapper.ts:61

`Static`has

has(type: keyof ChartTypeRegistry): boolean
Parameters
- type: keyof ChartTypeRegistry
Returns boolean
Inherited from ArcChartWrapper.has
- Defined in src/ChartWrapper.ts:77

`Static`register

register<TType extends keyof ChartTypeRegistry, TInstance>(
type: TType,
wrapperClass: Constructor<TType, TInstance>,
): void
Type Parameters
- TType extends keyof ChartTypeRegistry
- TInstance
Parameters
- type: TType
- wrapperClass: Constructor<TType, TInstance>
Returns void
Inherited from ArcChartWrapper.register
- Defined in src/ChartWrapper.ts:72

config

makeConfig

makeConfig(id?: string): ChartConfig
Beta
Parameters
- Optionalid: string
Returns ChartConfig
Description
레거시 지원용 차트 설정 객체를 생성합니다.

Since
1.0.0
Implementation of PieChartBuilder.makeConfig
Overrides ArcChartWrapper.makeConfig
- Defined in src/PieChartWrapper.ts:46

dataset

getChartData

getChartData(uid: string): CustomChartDatasets<"pie">
Beta
Parameters
- uid: string
Returns CustomChartDatasets<"pie">
Description
특정 데이터셋을 식별자(UID 또는 라벨)로 조회합니다.

Since
1.0.0
Example
```
const dataset = chart.getChartData('dataset-uid-or-label');
console.log(dataset);
@beta
```
Implementation of PieChartBuilder.getChartData
Inherited from ArcChartWrapper.getChartData
- Defined in src/ChartWrapper.ts:242

setChartData

setChartData(uid: string, newDataset: CustomChartDatasets<"pie">): void
Beta
Parameters
- uid: string
- newDataset: CustomChartDatasets<"pie">
Returns void
Description
특정 데이터셋을 식별자(UID 또는 라벨)로 찾아 새로운 데이터셋으로 교체합니다.

Since
1.0.0
Example
```
chart.setChartData('dataset-uid-or-label', { label: 'New Dataset', data: [10, 20, 30] });
@beta
```
Implementation of PieChartBuilder.setChartData
Inherited from ArcChartWrapper.setChartData
- Defined in src/ChartWrapper.ts:270

options

onResize

onResize(
    callback: (
        chart: Chart<"pie">,
        size: { height: number; width: number },
    ) => void,
): this
Beta
Parameters
- callback: (chart: Chart<"pie">, size: { height: number; width: number }) => void
Returns this
Description
차트 리사이즈 이벤트 콜백 함수를 설정합니다.

Since
1.0.0
Implementation of PieChartBuilder.onResize
Inherited from ArcChartWrapper.onResize
- Defined in src/ChartWrapper.ts:161

setLegend

setLegend(legendOptions: DeepPartial<LegendOptions<TType>>): this

Parameters

legendOptions: DeepPartial<LegendOptions<TType>>

Returns this

Description

차트의 범례를 설정합니다.

Since

1.0.0

Example

chart.setLegend({
position: 'bottom',
  align: 'center',
  labels: {
    boxWidth: 40,
    padding: 15,
    font: {
      size: 14,
      weight: 'bold'
    },
    color: '#333',
    usePointStyle: true
  }
  onClick: (e, legendItem, legend) => {
    console.log('Legend clicked:', legendItem);
  }
});

setTitle

setTitle(titleOptions: DeepPartial<CommonCartesianTitleConfig>): this
Parameters
- titleOptions: DeepPartial<CommonCartesianTitleConfig>
Returns this
Description
차트의 제목을 설정합니다.

Since
1.0.0
Example
```
chart.setTitle({
  text: '차트 제목',
  align: 'center'  // 'start' | 'center' | 'end'
});
```
Implementation of PieChartBuilder.setTitle
Inherited from ArcChartWrapper.setTitle
- Defined in src/ChartWrapper.ts:183

plugin

hasPlugin

hasPlugin(pluginId: string): boolean
Parameters
- pluginId: string
Returns boolean
Description
플러그인이 존재하는지 확인합니다.

Since
1.0.0
Implementation of PieChartBuilder.hasPlugin
Inherited from ArcChartWrapper.hasPlugin
- Defined in src/ChartWrapper.ts:145

removePlugin

removePlugin(pluginId: string): this
Parameters
- pluginId: string
Returns this
Description
플러그인을 제거합니다.

Since
1.0.0
Implementation of PieChartBuilder.removePlugin
Inherited from ArcChartWrapper.removePlugin
- Defined in src/ChartWrapper.ts:127

setPlugin

setPlugin(plugin: any, replaceIfExists?: boolean): this
Parameters
- plugin: any
- replaceIfExists: boolean = true
Returns this
Description
플러그인을 추가합니다.

Since
1.0.0
Implementation of PieChartBuilder.setPlugin
Inherited from ArcChartWrapper.setPlugin
- Defined in src/ChartWrapper.ts:92

Class PieChartWrapper

Hierarchy (View Summary)

Implements

Index

Chart

Dataset

Options

Other

config

dataset

options

plugin

Chart

build

Parameters

Returns ChartConfig

Description

Since

Dataset

ProtecteddecorateDataset

Parameters

Returns void

Description

Returns

Since

highlightMaxSegment

Parameters

Returns this

Description

Since

highlightMinSegment

Parameters

Returns this

Description

Since

setAllBorderColor

Parameters

Returns this

Description

Since

setAllBorderWidth

Parameters

Returns this

Description

Since

setAllSegmentOffsets

Parameters

Returns this

Description

Since

Example

setBorderColor

Parameters

Returns this

Description

Since

setBorderWidth

Parameters

Returns this

Description

Since

setGradientColors

Parameters

Returns this

Description

Since

setSegmentColors

Parameters

Returns this

Description

Since

setSegmentColorWhere

Parameters

Returns this

Description

Since

Example

setSegmentImages

Parameters

Returns this

`Protected`decorateDataset

`Protected`labels

`Protected`options

`Protected` `Optional`plugins

`Readonly`type

`Static`registry

`Protected`datasets

`Protected`configAop

`Private`generateGradientColors

`Private`hexToRgb