---
url: /ko/api-reference/chart.md
---
## 차트

57가지 차트 유형을 지원합니다. `add_chart`로 시트에 차트를 추가하며, 셀 범위로 위치와 크기를 지정합니다.

### `add_chart(sheet, from_cell, to_cell, config)` / `addChart(sheet, fromCell, toCell, config)`

시트에 차트를 추가합니다. `from_cell`은 차트의 왼쪽 상단, `to_cell`은 오른쪽 하단 위치를 나타냅니다.

**Rust:**

```rust
use sheetkit::chart::*;

wb.add_chart("Sheet1", "E1", "L15", &ChartConfig {
    chart_type: ChartType::Col,
    title: Some("Sales Report".into()),
    series: vec![
        ChartSeries {
            name: "Revenue".into(),
            categories: "Sheet1!$A$2:$A$6".into(),
            values: "Sheet1!$B$2:$B$6".into(),
            x_values: None,
            bubble_sizes: None,
        },
    ],
    show_legend: true,
    view_3d: None,
})?;
```

**TypeScript:**

```typescript
wb.addChart("Sheet1", "E1", "L15", {
    chartType: "col",
    title: "Sales Report",
    series: [
        {
            name: "Revenue",
            categories: "Sheet1!$A$2:$A$6",
            values: "Sheet1!$B$2:$B$6",
        },
    ],
    showLegend: true,
});
```

> Node.js에서 `chartType`은 지원되는 값만 허용됩니다. 지원되지 않는 값은 더 이상 기본값으로 대체되지 않고 오류를 반환합니다.

### ChartSeries 구조

| 속성 | 타입 | 필수 | 설명 |
|------|------|------|------|
| `name` | `string` | O | 시리즈 이름 또는 셀 참조 |
| `categories` | `string` | O | 카테고리 데이터 범위 |
| `values` | `string` | O | 값 데이터 범위 |
| `x_values` / `xValues` | `string?` | X | Scatter/Bubble용 X 축 범위 |
| `bubble_sizes` / `bubbleSizes` | `string?` | X | Bubble 차트용 크기 범위 |

### `delete_chart(sheet, cell)` / `deleteChart(sheet, cell)`

지정된 셀에 고정된 차트를 삭제합니다. 차트 데이터, drawing anchor, relationship 항목, content type override를 모두 제거합니다.

해당 셀에 차트가 없으면 오류가 반환됩니다.

**매개변수:**

| 매개변수 | 타입 | 설명 |
|----------|------|------|
| `sheet` | `&str` / `string` | 시트 이름 |
| `cell` | `&str` / `string` | 차트의 anchor 셀 (예: `"D1"`) |

**Rust:**

```rust
wb.delete_chart("Sheet1", "D1")?;
```

**TypeScript:**

```typescript
wb.deleteChart("Sheet1", "D1");
```

### View3DConfig 구조

3D 차트의 시점을 설정합니다. 3D 차트 유형에서는 지정하지 않으면 자동으로 기본값이 적용됩니다.

| 속성 | 타입 | 설명 |
|------|------|------|
| `rot_x` / `rotX` | `i32?` / `number?` | X축 회전 각도 |
| `rot_y` / `rotY` | `i32?` / `number?` | Y축 회전 각도 |
| `depth_percent` / `depthPercent` | `u32?` / `number?` | 깊이 비율 (100 = 기본) |
| `right_angle_axes` / `rightAngleAxes` | `bool?` / `boolean?` | 직각 축 사용 여부 |
| `perspective` | `u32?` / `number?` | 원근 각도 |

### 차트 유형 전체 목록 (57종)

#### 세로 막대 (Column) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `col` | `ChartType::Col` | 세로 막대 |
| `colStacked` | `ChartType::ColStacked` | 누적 세로 막대 |
| `colPercentStacked` | `ChartType::ColPercentStacked` | 100% 누적 세로 막대 |
| `col3D` | `ChartType::Col3D` | 3D 세로 막대 |
| `col3DStacked` | `ChartType::Col3DStacked` | 3D 누적 세로 막대 |
| `col3DPercentStacked` | `ChartType::Col3DPercentStacked` | 3D 100% 누적 세로 막대 |
| `col3DCone` | `ChartType::Col3DCone` | 3D 원뿔 세로 막대 |
| `col3DConeStacked` | `ChartType::Col3DConeStacked` | 3D 누적 원뿔 세로 막대 |
| `col3DConePercentStacked` | `ChartType::Col3DConePercentStacked` | 3D 100% 누적 원뿔 세로 막대 |
| `col3DPyramid` | `ChartType::Col3DPyramid` | 3D 피라미드 세로 막대 |
| `col3DPyramidStacked` | `ChartType::Col3DPyramidStacked` | 3D 누적 피라미드 세로 막대 |
| `col3DPyramidPercentStacked` | `ChartType::Col3DPyramidPercentStacked` | 3D 100% 누적 피라미드 세로 막대 |
| `col3DCylinder` | `ChartType::Col3DCylinder` | 3D 원통 세로 막대 |
| `col3DCylinderStacked` | `ChartType::Col3DCylinderStacked` | 3D 누적 원통 세로 막대 |
| `col3DCylinderPercentStacked` | `ChartType::Col3DCylinderPercentStacked` | 3D 100% 누적 원통 세로 막대 |

#### 가로 막대 (Bar) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `bar` | `ChartType::Bar` | 가로 막대 |
| `barStacked` | `ChartType::BarStacked` | 누적 가로 막대 |
| `barPercentStacked` | `ChartType::BarPercentStacked` | 100% 누적 가로 막대 |
| `bar3D` | `ChartType::Bar3D` | 3D 가로 막대 |
| `bar3DStacked` | `ChartType::Bar3DStacked` | 3D 누적 가로 막대 |
| `bar3DPercentStacked` | `ChartType::Bar3DPercentStacked` | 3D 100% 누적 가로 막대 |

#### 꺾은선 (Line) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `line` | `ChartType::Line` | 꺾은선 |
| `lineStacked` | `ChartType::LineStacked` | 누적 꺾은선 |
| `linePercentStacked` | `ChartType::LinePercentStacked` | 100% 누적 꺾은선 |
| `line3D` | `ChartType::Line3D` | 3D 꺾은선 |

#### 원형 (Pie) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `pie` | `ChartType::Pie` | 원형 |
| `pie3D` | `ChartType::Pie3D` | 3D 원형 |
| `doughnut` | `ChartType::Doughnut` | 도넛형 |
| `pieOfPie` | `ChartType::PieOfPie` | 원형 대 원형 |
| `barOfPie` | `ChartType::BarOfPie` | 원형 대 가로 막대 |

#### 영역 (Area) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `area` | `ChartType::Area` | 영역 |
| `areaStacked` | `ChartType::AreaStacked` | 누적 영역 |
| `areaPercentStacked` | `ChartType::AreaPercentStacked` | 100% 누적 영역 |
| `area3D` | `ChartType::Area3D` | 3D 영역 |
| `area3DStacked` | `ChartType::Area3DStacked` | 3D 누적 영역 |
| `area3DPercentStacked` | `ChartType::Area3DPercentStacked` | 3D 100% 누적 영역 |

#### 분산형 (Scatter) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `scatter` | `ChartType::Scatter` | 분산형 (표식만) |
| `scatterSmooth` | `ChartType::ScatterSmooth` | 부드러운 선 |
| `scatterStraight` | `ChartType::ScatterLine` | 직선 |

#### 방사형 (Radar) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `radar` | `ChartType::Radar` | 방사형 |
| `radarFilled` | `ChartType::RadarFilled` | 채워진 방사형 |
| `radarMarker` | `ChartType::RadarMarker` | 표식이 있는 방사형 |

#### 주식 (Stock) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `stockHLC` | `ChartType::StockHLC` | 고가-저가-종가 |
| `stockOHLC` | `ChartType::StockOHLC` | 시가-고가-저가-종가 |
| `stockVHLC` | `ChartType::StockVHLC` | 거래량-고가-저가-종가 |
| `stockVOHLC` | `ChartType::StockVOHLC` | 거래량-시가-고가-저가-종가 |

주식 차트는 차트 타입 이름에 지정된 순서로 series를 제공해야 합니다. `stockHLC`, `stockOHLC`, `stockVHLC`, `stockVOHLC`에는 각각 정확히 3개, 4개, 4개, 5개의 series가 필요하며, 다른 개수를 제공하면 `add_chart` / `addChart`가 오류를 반환합니다.

#### 표면형 및 등고선 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `surface` | `ChartType::Surface` | 표면형 |
| `surfaceTop` | `ChartType::Surface3D` | 3D 표면형 |
| `surfaceWireframe` | `ChartType::SurfaceWireframe` | 와이어프레임 표면형 |
| `surfaceTopWireframe` | `ChartType::SurfaceWireframe3D` | 3D 와이어프레임 표면형 |
| `contour` | `ChartType::Contour` | 등고선형 (2D 표면 투영) |
| `wireframeContour` | `ChartType::WireframeContour` | 와이어프레임 등고선형 |

#### 기타 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `bubble` | `ChartType::Bubble` | 거품형 |
| `bubble3D` | `ChartType::Bubble3D` | 3D 거품형 |

#### 콤보 (Combo) 차트

| 타입 문자열 | Rust Enum | 설명 |
|------------|-----------|------|
| `colLine` | `ChartType::ColLine` | 세로 막대 + 꺾은선 |
| `colLineStacked` | `ChartType::ColLineStacked` | 누적 세로 막대 + 꺾은선 |
| `colLinePercentStacked` | `ChartType::ColLinePercentStacked` | 100% 누적 세로 막대 + 꺾은선 |

***
