Chart
Chart menunjukkan perubahan angka dari waktu ke waktu atau perbandingannya antarkategori, misalnya streaming per bulan per platform atau pendapatan royalti.
Kapan dipakai
Section titled “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.
Anatomi
Section titled “Anatomi”- 1Seri batang di chart-1
- 2Seri garis di chart-2
- 3Sumbu
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.
| 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. |
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> )}<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>// 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
Section titled “Line chart”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> )}<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>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
Section titled “Instal”npx shadcn@latest add https://design.sosialoka.tech/r/react/chart.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/chart.jsonReact menggambar dengan Recharts dan Vue dengan Unovis; Flutter memakai fl_chart.
Aksesibilitas
Section titled “Aksesibilitas”- Setiap grafik punya alternatif teks:
ChartTablemenampilkan tabel tersembunyi berisi angka yang sama, dan di Flutter grafiknya dibungkus labelSemanticsyang 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
Section titled “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.
