# Chart

> Menggambar angka dari waktu ke waktu atau antarkategori, dengan tabel berisi angka yang sama.

Chart menunjukkan perubahan angka dari waktu ke waktu atau perbandingannya antarkategori, misalnya streaming per bulan per platform atau pendapatan royalti.

## Kapan dipakai

- **Bar** untuk membandingkan jumlah antara beberapa kategori atau bulan.
- **Line** untuk satu atau dua ukuran di banyak titik waktu, misalnya pendapatan per bulan.
- **Area** hanya untuk satu total dari waktu ke waktu; area bertumpuk sulit dibaca.
- Maksimal 5 seri. Sisanya digabung ke "Lainnya", atau pisahkan grafiknya.
- Dengan 4 seri atau lebih, beri label langsung di setiap garis atau kelompok bar, bukan hanya di legenda.
- Di scatter plot dan peta, tempat warna apa pun bisa bersebelahan, pakai maksimal 3 seri.
- Satu grafik, satu sumbu. Dua ukuran dengan skala berbeda dibuat jadi dua grafik.
- Satu angka utama cukup ditampilkan sebagai kartu statistik, bukan grafik.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/chart/_

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/chart/_

## Anatomi

1. Seri batang di chart-1
2. Seri garis di chart-2
3. Sumbu

[Card](https://design.sosialoka.tech/id/components/card/) dengan judul dan deskripsi singkat, grafiknya, legenda kalau ada dua seri atau lebih, dan tabel tersembunyi berisi angka yang sama.

| Bagian | Gaya |
| --- | --- |
| Seri | `chart-1` sampai `chart-5`, berurutan. `chart-1` adalah hue produk sendiri. Tidak pernah memakai warna status. |
| Grid | Hanya garis horizontal, warna `border`. Tanpa garis sumbu. |
| Label sumbu | `text-xs`, `muted-foreground`. |
| Bar | Ujung atas membulat 4px, berjarak 2px. |
| Line | 2px, tanpa titik sampai di-hover. |
| Tooltip | Permukaan popover: `rounded-lg`, `border`, `bg-popover`, `shadow-lg`. |
| Angka | `tabular-nums`, mengikuti locale produk (`12,400` dalam bahasa Inggris, `12.400` dalam bahasa Indonesia), Rupiah dua desimal (`Rp 1.890.420,25`). |

Warna grafik adalah token dengan kontras 3:1 di `background` dan `card`. Seri yang bersebelahan, sesuai urutannya, tetap bisa dibedakan pembaca buta warna; warna yang berjauhan dalam urutan bisa terlihat mirip, karena itu 4 seri atau lebih butuh label langsung. Lihat [Warna](https://design.sosialoka.tech/id/foundations/color/#palet-grafik).

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `ChartContainer config` | `ChartContainer :config` | warna dari `context.sosialoka.chart1`… | `ChartConfig` | tidak ada | Label dan warna tiap seri, misalnya `{ color: "var(--chart-1)" }`. |
| children Recharts | children Unovis | `fl_chart` `BarChart`, `LineChart` | komponen | tidak ada | Grafiknya sendiri. |
| `ChartTooltipContent formatter` | `formatter` | `getTooltipItem` | fungsi | angka sesuai `locale` | Format nilai, misalnya Rupiah. |
| `ChartTooltipContent locale`, `ChartTable locale` | `locale` | locale `NumberFormat` | teks | `en-GB` | Cara angka ditulis kalau tidak ada formatter, misalnya `"id-ID"` untuk `12.400`. |
| `ChartTable caption labelKey labelHeader data config format` | sama | `Semantics label` | | tidak ada | Angka yang sama untuk pembaca layar. Selalu pasang. |

## Kode

**React**
```tsx
import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import {
  ChartContainer,
  ChartLegend,
  ChartLegendContent,
  ChartTable,
  ChartTooltip,
  ChartTooltipContent,
  type ChartConfig,
} from "@/components/ui/chart"

const data = [
  { month: "Jun", spotify: 8200, youtube: 5100 },
  { month: "Jul", spotify: 9100, youtube: 5600 },
  { month: "Agu", spotify: 9800, youtube: 6900 },
  { month: "Sep", spotify: 10600, youtube: 7300 },
  { month: "Okt", spotify: 11300, youtube: 8100 },
  { month: "Nov", spotify: 12400, youtube: 8800 },
]

const config = {
  spotify: { label: "Spotify", color: "var(--chart-1)" },
  youtube: { label: "YouTube Music", color: "var(--chart-2)" },
} satisfies ChartConfig

const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)

export default function ChartDemo() {
  return (
    <Card className="w-full max-w-xl">
      <CardHeader>
        <CardTitle>Streaming per bulan</CardTitle>
        <CardDescription>Jun–Nov 2026, semua rilis</CardDescription>
      </CardHeader>
      <CardContent>
        <ChartContainer config={config} className="aspect-auto h-64 w-full">
          <BarChart data={data} barGap={2}>
            <CartesianGrid vertical={false} />
            <XAxis dataKey="month" tickLine={false} axisLine={false} tickMargin={8} />
            <YAxis tickLine={false} axisLine={false} tickMargin={8} width={48} tickFormatter={compact} />
            <ChartTooltip cursor={false} content={<ChartTooltipContent locale="id-ID" />} />
            <ChartLegend content={<ChartLegendContent />} />
            <Bar dataKey="spotify" fill="var(--color-spotify)" radius={[4, 4, 0, 0]} maxBarSize={20} />
            <Bar dataKey="youtube" fill="var(--color-youtube)" radius={[4, 4, 0, 0]} maxBarSize={20} />
          </BarChart>
        </ChartContainer>
        <ChartTable locale="id-ID" caption="Streaming per bulan, Jun–Nov 2026" labelHeader="Bulan" labelKey="month" data={data} config={config} />
      </CardContent>
    </Card>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import type { ChartConfig } from "@/components/ui/chart"
import { VisAxis, VisGroupedBar, VisXYContainer } from "@unovis/vue"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import {
  ChartContainer,
  ChartCrosshair,
  ChartLegendContent,
  ChartTable,
  ChartTooltip,
  ChartTooltipContent,
  componentToString,
} from "@/components/ui/chart"

const data = [
  { month: "Jun", spotify: 8200, youtube: 5100 },
  { month: "Jul", spotify: 9100, youtube: 5600 },
  { month: "Agu", spotify: 9800, youtube: 6900 },
  { month: "Sep", spotify: 10600, youtube: 7300 },
  { month: "Okt", spotify: 11300, youtube: 8100 },
  { month: "Nov", spotify: 12400, youtube: 8800 },
]
type Row = (typeof data)[number]

const config = {
  spotify: { label: "Spotify", color: "var(--chart-1)" },
  youtube: { label: "YouTube Music", color: "var(--chart-2)" },
} satisfies ChartConfig

const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)
</script>

<template>
  <Card class="w-full max-w-xl">
    <CardHeader>
      <CardTitle>Streaming per bulan</CardTitle>
      <CardDescription>Jun–Nov 2026, semua rilis</CardDescription>
    </CardHeader>
    <CardContent>
      <ChartContainer :config="config" class="aspect-auto h-64 w-full">
        <VisXYContainer :data="data" :padding="{ top: 8 }">
          <VisGroupedBar
            :x="(_: Row, i: number) => i"
            :y="[(d: Row) => d.spotify, (d: Row) => d.youtube]"
            :color="[config.spotify.color, config.youtube.color]"
            :rounded-corners="4"
            :bar-padding="0.3"
            :group-max-width="44"
          />
          <VisAxis type="x" :x="(_: Row, i: number) => i" :tick-format="(i: number) => data[i]?.month" :num-ticks="6" :grid-line="false" :tick-line="false" :domain-line="false" />
          <VisAxis type="y" :num-ticks="4" :tick-format="compact" :tick-line="false" :domain-line="false" />
          <ChartTooltip />
          <ChartCrosshair :template="componentToString(config, ChartTooltipContent, { labelKey: 'month', locale: 'id-ID' })" color="transparent" />
        </VisXYContainer>
        <ChartLegendContent />
      </ChartContainer>
      <ChartTable locale="id-ID" caption="Streaming per bulan, Jun–Nov 2026" label-header="Bulan" label-key="month" :data="data" :config="config" />
    </CardContent>
  </Card>
</template>
```

**Flutter**
```dart
// Charts come from fl_chart, colored with the chart palette of the Sosialoka theme (context.sosialoka.chart1…5).
// The bars are hidden from screen readers; a Semantics label carries the numbers instead.
import 'package:fl_chart/fl_chart.dart';
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _months = ['Jun', 'Jul', 'Agu', 'Sep', 'Okt', 'Nov'];
const _spotify = [8200, 9100, 9800, 10600, 11300, 12400];
const _youtube = [5100, 5600, 6900, 7300, 8100, 8800];

class ChartDemo extends StatelessWidget {
  const ChartDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    final number = NumberFormat.decimalPattern('id');
    final summary = [
      for (var i = 0; i < _months.length; i++)
        '${_months[i]}: Spotify ${number.format(_spotify[i])}, YouTube Music ${number.format(_youtube[i])}',
    ].join('; ');
    Widget legend(Color color, String label) => Row(
      mainAxisSize: MainAxisSize.min,
      children: [
        Container(
          width: 10,
          height: 10,
          decoration: BoxDecoration(color: color, borderRadius: BorderRadius.circular(2)),
        ),
        const SizedBox(width: 6),
        Text(label, style: theme.textTheme.muted),
      ],
    );
    return ShadCard(
      width: 576,
      title: Text('Streaming per bulan', style: theme.textTheme.h4),
      description: const Text('Jun–Nov 2026, semua rilis'),
      child: Padding(
        padding: const EdgeInsets.only(top: 16),
        child: Column(
          children: [
            Semantics(
              label: 'Streaming per bulan, Jun–Nov 2026. $summary.',
              child: ExcludeSemantics(
                child: SizedBox(
                  height: 220,
                  child: BarChart(
                    BarChartData(
                      // The tooltip sits on the popover surface, like the web charts.
                      barTouchData: BarTouchData(
                        touchTooltipData: BarTouchTooltipData(
                          getTooltipColor: (_) => theme.colorScheme.popover,
                          tooltipBorder: BorderSide(color: theme.colorScheme.border),
                          getTooltipItem: (group, _, rod, rodIndex) => BarTooltipItem(
                            '${rodIndex == 0 ? 'Spotify' : 'YouTube Music'} ${number.format(rod.toY)}',
                            theme.textTheme.small.copyWith(color: theme.colorScheme.popoverForeground),
                          ),
                        ),
                      ),
                      gridData: FlGridData(
                        drawVerticalLine: false,
                        getDrawingHorizontalLine: (_) => FlLine(color: theme.colorScheme.border, strokeWidth: 1),
                      ),
                      borderData: FlBorderData(show: false),
                      titlesData: FlTitlesData(
                        topTitles: const AxisTitles(),
                        rightTitles: const AxisTitles(),
                        leftTitles: AxisTitles(
                          sideTitles: SideTitles(
                            showTitles: true,
                            reservedSize: 44,
                            getTitlesWidget: (value, meta) => Text(
                              NumberFormat.compact(locale: 'id').format(value),
                              style: theme.textTheme.muted,
                            ),
                          ),
                        ),
                        bottomTitles: AxisTitles(
                          sideTitles: SideTitles(
                            showTitles: true,
                            getTitlesWidget: (value, meta) => Text(_months[value.toInt()], style: theme.textTheme.muted),
                          ),
                        ),
                      ),
                      barGroups: [
                        for (var i = 0; i < _months.length; i++)
                          BarChartGroupData(
                            x: i,
                            barsSpace: 2,
                            barRods: [
                              BarChartRodData(
                                toY: _spotify[i].toDouble(),
                                color: c.chart1,
                                width: 14,
                                borderRadius: const BorderRadius.vertical(top: Radius.circular(4)),
                              ),
                              BarChartRodData(
                                toY: _youtube[i].toDouble(),
                                color: c.chart2,
                                width: 14,
                                borderRadius: const BorderRadius.vertical(top: Radius.circular(4)),
                              ),
                            ],
                          ),
                      ],
                    ),
                  ),
                ),
              ),
            ),
            const SizedBox(height: 12),
            Wrap(spacing: 16, children: [legend(c.chart1, 'Spotify'), legend(c.chart2, 'YouTube Music')]),
          ],
        ),
      ),
    );
  }
}
```

### Line chart

**React**
```tsx
import { CartesianGrid, Line, LineChart, XAxis, YAxis } from "recharts"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import { ChartContainer, ChartTable, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@/components/ui/chart"

const data = [
  { month: "Jun", revenue: 1250000 },
  { month: "Jul", revenue: 1418500.5 },
  { month: "Agu", revenue: 1377250 },
  { month: "Sep", revenue: 1602000.75 },
  { month: "Okt", revenue: 1745300 },
  { month: "Nov", revenue: 1890420.25 },
]

const config = { revenue: { label: "Pendapatan" , color: "var(--chart-1)" } } satisfies ChartConfig

const rupiah = (value: unknown) =>
  new Intl.NumberFormat("id-ID", { style: "currency", currency: "IDR", minimumFractionDigits: 2 }).format(Number(value))
const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)

export default function ChartLineDemo() {
  return (
    <Card className="w-full max-w-xl">
      <CardHeader>
        <CardTitle>Pendapatan royalti</CardTitle>
        <CardDescription>Jun–Nov 2026, dalam Rupiah</CardDescription>
      </CardHeader>
      <CardContent>
        <ChartContainer config={config} className="aspect-auto h-56 w-full">
          <LineChart data={data} margin={{ right: 8 }}>
            <CartesianGrid vertical={false} />
            <XAxis dataKey="month" tickLine={false} axisLine={false} tickMargin={8} />
            <YAxis tickLine={false} axisLine={false} tickMargin={8} width={48} tickFormatter={compact} />
            <ChartTooltip cursor={false} content={<ChartTooltipContent formatter={(value) => rupiah(value)} hideIndicator />} />
            <Line dataKey="revenue" type="monotone" stroke="var(--color-revenue)" strokeWidth={2} dot={false} activeDot={{ r: 4, strokeWidth: 2 }} />
          </LineChart>
        </ChartContainer>
        <ChartTable caption="Pendapatan royalti, Jun–Nov 2026" labelHeader="Bulan" labelKey="month" data={data} config={config} format={rupiah} />
      </CardContent>
    </Card>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import type { ChartConfig } from "@/components/ui/chart"
import { VisAxis, VisLine, VisXYContainer } from "@unovis/vue"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import { ChartContainer, ChartCrosshair, ChartTable, ChartTooltip, ChartTooltipContent, componentToString } from "@/components/ui/chart"

const data = [
  { month: "Jun", revenue: 1250000 },
  { month: "Jul", revenue: 1418500.5 },
  { month: "Agu", revenue: 1377250 },
  { month: "Sep", revenue: 1602000.75 },
  { month: "Okt", revenue: 1745300 },
  { month: "Nov", revenue: 1890420.25 },
]
type Row = (typeof data)[number]

const config = { revenue: { label: "Pendapatan", color: "var(--chart-1)" } } satisfies ChartConfig

const rupiah = (value: unknown) =>
  new Intl.NumberFormat("id-ID", { style: "currency", currency: "IDR", minimumFractionDigits: 2 }).format(Number(value))
const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)
</script>

<template>
  <Card class="w-full max-w-xl">
    <CardHeader>
      <CardTitle>Pendapatan royalti</CardTitle>
      <CardDescription>Jun–Nov 2026, dalam Rupiah</CardDescription>
    </CardHeader>
    <CardContent>
      <ChartContainer :config="config" class="aspect-auto h-56 w-full" cursor>
        <VisXYContainer :data="data" :padding="{ top: 8, right: 8 }">
          <VisLine :x="(_: Row, i: number) => i" :y="(d: Row) => d.revenue" :color="config.revenue.color" :line-width="2" />
          <VisAxis type="x" :x="(_: Row, i: number) => i" :tick-format="(i: number) => data[i]?.month" :num-ticks="6" :grid-line="false" :tick-line="false" :domain-line="false" />
          <VisAxis type="y" :num-ticks="4" :tick-format="compact" :tick-line="false" :domain-line="false" />
          <ChartTooltip />
          <ChartCrosshair :template="componentToString(config, ChartTooltipContent, { labelKey: 'month', hideIndicator: true, formatter: rupiah })" :color="config.revenue.color" />
        </VisXYContainer>
      </ChartContainer>
      <ChartTable caption="Pendapatan royalti, Jun–Nov 2026" label-header="Bulan" label-key="month" :data="data" :config="config" :format="rupiah" />
    </CardContent>
  </Card>
</template>
```

**Flutter**
```dart
import 'package:fl_chart/fl_chart.dart';
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const revenue = [
  (month: 'Jun', value: 1250000.0),
  (month: 'Jul', value: 1418500.5),
  (month: 'Agu', value: 1377250.0),
  (month: 'Sep', value: 1602000.75),
  (month: 'Okt', value: 1745300.0),
  (month: 'Nov', value: 1890420.25),
];

// One series in chart-1, with Rupiah to two decimals. Screen readers get the same numbers as one sentence.
class ChartLineDemo extends StatelessWidget {
  const ChartLineDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    final rupiah = NumberFormat.currency(locale: 'id', symbol: 'Rp', decimalDigits: 2);
    final compact = NumberFormat.compact(locale: 'id');
    final axis = theme.textTheme.muted.copyWith(fontSize: 12);
    final summary = [
      'Pendapatan royalti, Jun–Nov 2026.',
      for (final r in revenue) '${r.month}: ${rupiah.format(r.value)}.',
    ].join(' ');

    return ShadCard(
      width: 576,
      title: Text('Pendapatan royalti', style: theme.textTheme.h4),
      description: const Text('Jun–Nov 2026, dalam Rupiah'),
      child: Semantics(
        label: summary,
        child: ExcludeSemantics(
          child: Padding(
            padding: const EdgeInsets.only(top: 16),
            child: SizedBox(
              height: 220,
              child: LineChart(
                LineChartData(
                  minY: 1000000,
                  maxY: 2000000,
                  lineBarsData: [
                    LineChartBarData(
                      spots: [for (var i = 0; i < revenue.length; i++) FlSpot(i.toDouble(), revenue[i].value)],
                      isCurved: true,
                      color: c.chart1,
                      barWidth: 2,
                      dotData: const FlDotData(show: false),
                    ),
                  ],
                  gridData: FlGridData(
                    drawVerticalLine: false,
                    horizontalInterval: 250000,
                    getDrawingHorizontalLine: (_) => FlLine(color: theme.colorScheme.border, strokeWidth: 1),
                  ),
                  borderData: FlBorderData(show: false),
                  titlesData: FlTitlesData(
                    topTitles: const AxisTitles(),
                    rightTitles: const AxisTitles(),
                    bottomTitles: AxisTitles(
                      sideTitles: SideTitles(
                        showTitles: true,
                        interval: 1,
                        getTitlesWidget: (value, meta) => SideTitleWidget(meta: meta, child: Text(revenue[value.toInt()].month, style: axis)),
                      ),
                    ),
                    leftTitles: AxisTitles(
                      sideTitles: SideTitles(
                        showTitles: true,
                        reservedSize: 44,
                        interval: 250000,
                        getTitlesWidget: (value, meta) => SideTitleWidget(meta: meta, child: Text(compact.format(value), style: axis)),
                      ),
                    ),
                  ),
                  lineTouchData: LineTouchData(
                    touchTooltipData: LineTouchTooltipData(
                      getTooltipColor: (_) => theme.colorScheme.popover,
                      tooltipBorder: BorderSide(color: theme.colorScheme.border),
                      getTooltipItems: (spots) => [
                        for (final s in spots)
                          LineTooltipItem(rupiah.format(s.y), theme.textTheme.small.copyWith(color: theme.colorScheme.popoverForeground)),
                      ],
                    ),
                  ),
                ),
              ),
            ),
          ),
        ),
      ),
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/chart.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/chart.json
```

React menggambar dengan Recharts dan Vue dengan Unovis; Flutter memakai `fl_chart`.

## Aksesibilitas

- Setiap grafik punya alternatif teks: `ChartTable` menampilkan tabel tersembunyi berisi angka yang sama, dan di Flutter grafiknya dibungkus label `Semantics` yang membacakannya.
- Gambar grafiknya disembunyikan dari pembaca layar dan tidak bisa difokus, jadi tabel menjadi satu-satunya sumber.
- Tooltip tidak pernah menjadi satu-satunya tempat sebuah angka.
- Legenda menamai seri setiap kali ada dua seri atau lebih, jadi warna bukan satu-satunya pembeda.

## Migrasi dari ApexCharts

Cover Clearance saat ini menggambar grafiknya dengan ApexCharts. Saat sebuah layar pindah ke design system ini, grafiknya ikut pindah ke Chart: data yang sama, warna `chart-n`, dan `ChartTable`.
