# 스파크라인

## Content

스파크라인(Sparkline)은 데이터를 빠르게 시각화하고 셀 내에서 컴팩트한 형태로 변환할 수 있도록 하는 작은 차트입니다. 셀 범위의 데이터를 사용하여 셀 수준에서 데이터를 쉽게 분석할 수 있도록 도와줍니다.

[setSparkline](/spreadjs/api/classes/GC.Spread.Sheets.Worksheet#setSparkline) 메서드를 사용하여 스파크라인 유형을 column, line 또는 winloss로 설정할 수 있으며, 특정 유형의 수식을 사용하여 SpreadJS에서 제공하는 다양한 스파크라인을 만들 수도 있습니다.

또한 제공된 데이터셋과 설정을 사용하여 사용자 정의 스파크라인 수식을 구현하고, [addSparklineEx](/spreadjs/api/classes/GC.Spread.Sheets.Workbook#addSparklineEx) 메서드를 사용하여 해당 사용자 정의 스파크라인을 추가할 수 있습니다.

>type=warning
> 참고: 수식을 사용하여 생성한 스파크라인은 Excel 파일로 내보낼 수 없습니다.

아래 이미지는 [Vbar 스파크라인](/spreadjs/docs/features/sparkmain/sparkvbar)의 실제 사용 예를 보여줍니다. 이 예는 여러 도시의 연간 온도 수준의 추세를 보여주며, 고온과 저온 데이터를 빠르게 파악하는 데 도움이 됩니다.

![](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/images/sparklineexample.png)

## 

## Sparklines의 유형

다음과 같은 스파크라인 유형을 스프레드시트에서 사용할 수 있습니다. 이미지를 클릭하면 해당 주제로 이동합니다.

| @cols=4:**스파크라인 유형** |
| :------: | :------: | :------: | :------: |
| [![columnsparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/columnsparkline.1f5845.png)](/spreadjs/docs/features/sparkmain/sparkcomp)<br>**열 스파크라인** | [![linesparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/linesparkline.4c3853.png)](/spreadjs/docs/features/sparkmain/sparkcomp)<br>**꺽은선 스파크라인** | [![winlosssparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/winlosssparkline.037226.png)](/spreadjs/docs/features/sparkmain/sparkcomp)<br>**승패 스파크라인** | [![sparkarea.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkarea.8fc49b.png)](/spreadjs/docs/features/sparkmain/sparkarea)<br>**영역형 스파크라인** |
| **[![sparkpie.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkpie.30e842.png)](/spreadjs/docs/features/sparkmain/sparkpie)원형 스파크라인** | [![sparkscatter.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkscatter.b168e3.png)](/spreadjs/docs/features/sparkmain/sparkscatter)<br>**분산형 스파크라인** | [![bullet-sparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/bullet-sparkline.4e4da9.png)](/spreadjs/docs/features/sparkmain/sparkbullet)<br>**글머리 기호 스파크라인** | [![sparkspread.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkspread.85e649.png)](/spreadjs/docs/features/sparkmain/sparkspread)<br>**분사형 스파크라인** |
| [![sparkstacked.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkstacked.83faad.png)](/spreadjs/docs/features/sparkmain/sparkstacked)<br>**누적형 스파크라인** | [![hbar-sparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/hbar-sparkline.4e1dab.png)](/spreadjs/docs/features/sparkmain/sparkhbar)<br>**Hbar 스파크라인** | [![vbar-sparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/vbar-sparkline.f89fbb.png)](/spreadjs/docs/features/sparkmain/sparkvbar)<br>**Vbar 스파크라인** | [![sparkboxplot.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkboxplot.bc0869.png)](/spreadjs/docs/features/sparkmain/sparkboxplot)<br>**상자 그림 스파크라인** |
| [![sparkvari.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkvari.674611.png)](/spreadjs/docs/features/sparkmain/sparkvari)<br>**변량 스파크라인** | [![sparkcascade.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkcascade.8e05d2.png)](/spreadjs/docs/features/sparkmain/sparkcascade)<br>**계단식 스파크라인** | [![sparkmonth.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkmonth.083c98.png)](/spreadjs/docs/features/sparkmain/sparkmonth)<br>**월 스파크라인** | [![sparkyear.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/sparkyear.6a15e5.png)](/spreadjs/docs/features/sparkmain/sparkyear)<br>**연도 스파크라인** |
| [![pareto-sparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/pareto-sparkline.d424a6.png)](/spreadjs/docs/features/sparkmain/sparkpareto)<br>**파레토 스파크라인** | [![rangeblock-spark.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/rangeblock-spark.37cca9.png)](/spreadjs/docs/features/sparkmain/rangeblock-sparkline)<br>**범위블록 스파크라인** | [![histogram-spark.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/histogram-spark.8e7474.png)](/spreadjs/docs/features/sparkmain/histogram-sparkline)<br>**히스토그램 스파크라인** | [![kpi-spark.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/kpi-spark.7b208b.png)](/spreadjs/docs/features/sparkmain/gauge-kpi-sparkline)<br>**게이지 KPI 스파크라인** |
| [![imagesparkline.png](https://gcdocumentsitekrblob.blob.core.windows.net/document-site-files/images/8d606653-16a0-474d-b9dc-e2b4d01c2446/imagesparkline.7e04e0.png)](/spreadjs/docs/features/sparkmain/image-sparkline)<br>**이미지 스파크라인** |

## 

## 스파크라인 그룹화

`sparkline`을 [groupSparkline](/spreadjs/api/classes/GC.Spread.Sheets.Worksheet#groupSparkline) 및 [ungroupSparkline](/spreadjs/api/classes/GC.Spread.Sheets.Worksheet#ungroupSparkline) 메서드를 사용하여 그룹화하거나 그룹 해제할 수 있습니다.
그룹화하면 여러 스파크라인에 변경 사항을 한 번에 적용할 수 있어 시간을 절약할 수 있습니다. 또한 동일한 유형의 스파크라인과 축을 사용하여 그룹으로 쉽게 비교할 수 있습니다.

```javascript
var spread = GC.Spread.Sheets.findControl(document.getElementById('ss'));
var sheet = spread.getActiveSheet();

var s1=  sheet.setSparkline(13, 0, data
        , GC.Spread.Sheets.Sparklines.DataOrientation.vertical
        , GC.Spread.Sheets.Sparklines.SparklineType.line
        , setting
        );
var s2 =sheet.setSparkline(13, 3, data
        , GC.Spread.Sheets.Sparklines.DataOrientation.vertical
        , GC.Spread.Sheets.Sparklines.SparklineType.column
        , setting
        );
var s3=  sheet.setSparkline(13, 6, data
        , GC.Spread.Sheets.Sparklines.DataOrientation.vertical
        , GC.Spread.Sheets.Sparklines.SparklineType.winloss
        , setting
        );

// 스파크라인 그룹화
var group = sheet.groupSparkline([s1,s2,s3]);

group.sparklineType = GC.Spread.Sheets.Sparklines.SparklineType.column;

// 스파크라인 그룹해제
sheet.ungroupSparkline(group);
```